Do I need to install external software for this skill to work?

Yes, this skill requires Pandoc and a LaTeX distribution (like XeLaTeX) to be installed on your system to perform the actual document conversion.

How are code blocks handled during page breaks?

The skill uses a production-proven LaTeX preamble that prevents code blocks from being split across pages, ensuring better readability in technical documents.

Can I hide certain parts of my Markdown from the final PDF?

Yes, the skill includes a Lua filter that allows you to hide HTML blocks from the PDF output using the --hide-details flag, which is perfect for hiding diagram source code.

Can I switch between landscape and portrait orientations?

Absolutely. The included build-pdf.sh script supports both modes; landscape is the default for wide data tables, while portrait can be toggled via a simple flag.

Does this skill handle bibliographies and citations?

Yes, it auto-detects .bib and .csl files in your directory and integrates them into the PDF generation process automatically using Pandoc's citation engine.

Pandoc PDF Document Generator

Name: Pandoc PDF Document Generator
Author: terrylica

byterrylica

•

Content Management

Converts Markdown documents into professional, print-ready PDFs using Pandoc and XeLaTeX with automated formatting and layout controls.

The Pandoc PDF Generation skill empowers developers to transform Markdown source files into high-quality PDF documents suitable for technical reports, architectural decision records (ADRs), and formal documentation. It leverages the XeLaTeX engine to handle complex requirements like automatic section numbering, table of contents generation, and bibliography management. With built-in production-grade templates and a universal build script, it ensures consistent formatting across different orientations and resolves common pain points such as awkward code block page breaks and ASCII diagram alignment issues.

Key Features

01Intelligent layout control including landscape/portrait toggles and page-break prevention for code blocks

02Advanced content filtering to hide technical metadata or source blocks from final PDF rendering

03Production-tuned LaTeX preamble for optimal table spacing and professional typography

048 GitHub stars

05Integrated ASCII diagram handling via graph-easy to prevent alignment issues in printed outputs

06Universal build script with auto-detection for input files, bibliographies, and CSL styles

Use Cases

01Building automated CI/CD pipelines for document generation with validated output quality

02Generating professional technical documentation from project READMEs and Markdown files

03Creating printable Architectural Decision Records (ADRs) with automated numbering and tables

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills pandoc-pdf-generation

For use in Claude.ai and ChatGPT

Download Skill