Agent-Skills.md

Agent Skills: 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.

UncategorizedID: James1218/claude-code-configurations/pandoc-pdf-generation

Install this agent skill to your local

pnpm dlx add-skill https://github.com/James1218/claude-code-configurations/tree/HEAD/skills/pandoc-pdf-generation

Skill Files

Browse the full folder contents for pandoc-pdf-generation.

Download Skill

Loading file tree…

skills/pandoc-pdf-generation/SKILL.md

Skill Metadata

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: