pandoc-pdf-generation
Generates professional PDFs from Markdown using Pandoc with XeLaTeX. Use when creating PDFs, needing section numbering, table of contents, bibliography, or custom LaTeX styling.
When & Why to Use This Skill
This Claude skill automates the transformation of Markdown files into professional-grade PDF documents using Pandoc and the XeLaTeX engine. It streamlines the creation of structured documents by handling complex formatting requirements such as automatic section numbering, table of contents generation, bibliography management, and custom LaTeX styling, ensuring high-quality output for technical and academic use.
Use Cases
- Technical Documentation: Convert project READMEs or documentation folders into polished, well-structured PDF manuals with consistent branding and professional layouts.
- Academic Publishing: Generate research papers and reports that require precise citation management, bibliographies, and LaTeX-quality typography without manual TeX coding.
- Automated Report Generation: Integrate the build scripts into development workflows to automatically produce formatted PDF reports from data-driven Markdown sources.
- Professional Whitepapers: Create high-end business documents with customized headers, footers, and table formatting using production-proven LaTeX templates.
| name | pandoc-pdf-generation |
|---|---|
| description | Generates professional PDFs from Markdown using Pandoc with XeLaTeX. Use when creating PDFs, needing section numbering, table of contents, bibliography, or custom LaTeX styling. |
Pandoc PDF Generation
Overview
Generate professional PDF documents from Markdown using Pandoc with the XeLaTeX engine. This skill covers automatic section numbering, table of contents, bibliography management, LaTeX customization, and common troubleshooting patterns learned through production use.
When to Use This Skill
Use this skill when:
- Converting Markdown to PDF with professional formatting requirements
- Needing automatic section numbering and table of contents
- Managing citations and bibliographies without manual duplication
- Controlling table formatting and page breaks in LaTeX output
- Building automated PDF generation workflows
Quick Start: Universal Build Script
Single Source of Truth Pattern
This skill provides production-proven assets in ~/.claude/skills/pandoc-pdf-generation/assets/:
table-spacing-template.tex- Production-tuned LaTeX preamble (booktabs, colortbl, ToC fixes)build-pdf.sh- Universal auto-detecting build script
From Any Project
# Create symlink once per project (git-friendly)
ln -s ~/.claude/skills/pandoc-pdf-generation/assets/build-pdf.sh build-pdf.sh
# Auto-detect single .md file in directory
./build-pdf.sh
# Or specify explicitly
./build-pdf.sh input.md output.pdf
Features:
- ✅ Auto-detects input file (if single .md exists)
- ✅ Auto-detects bibliography (
references.bib) and CSL files - ✅ Always uses production-proven LaTeX preamble from skill
- ✅ Pre-flight checks (pandoc, xelatex, files exist)
- ✅ Post-build validation (file size, page count)
Manual Command (For Reference)
pandoc document.md \
-o document.pdf \
--pdf-engine=xelatex \
--toc \
--toc-depth=3 \
--number-sections \
-V geometry:margin=1in \
-V mainfont="DejaVu Sans" \
-H ~/.claude/skills/pandoc-pdf-generation/assets/table-spacing-template.tex
Reference Documentation
For detailed information, see:
- Core Development Principles - START HERE - Universal principles learned from production failures
- YAML Front Matter Structure - YAML metadata patterns
- LaTeX Customization - Preamble and table formatting
- Bibliography & Citations - BibTeX and CSL styles
- Document Patterns - Document type templates
- Troubleshooting - Common issues and fixes