pandoc
Universal document converter for transforming Markdown to PDF, DOCX, HTML, LaTeX, and 40+ other formats. Covers templates, filters, citations with BibTeX/CSL, and batch conversion automation scripts.
Best use case
pandoc is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Universal document converter for transforming Markdown to PDF, DOCX, HTML, LaTeX, and 40+ other formats. Covers templates, filters, citations with BibTeX/CSL, and batch conversion automation scripts.
Teams using pandoc should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/pandoc/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How pandoc Compares
| Feature / Agent | pandoc | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Universal document converter for transforming Markdown to PDF, DOCX, HTML, LaTeX, and 40+ other formats. Covers templates, filters, citations with BibTeX/CSL, and batch conversion automation scripts.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Pandoc ## When to Use This Skill ### USE When - Converting Markdown to PDF with professional formatting - Creating Word documents from Markdown sources - Need reproducible document builds from plain text - Managing academic papers with citations (BibTeX/CSL) - Batch converting multiple documents - Need custom templates for consistent branding - Converting between multiple documentation formats - Creating LaTeX documents from Markdown - Need cross-references (figures, tables, equations) - Building automated document pipelines ### DON'T USE When - Building documentation websites (use MkDocs or Sphinx) - Need interactive documentation (use web frameworks) - Require real-time collaborative editing (use Google Docs) - Building slide presentations (use Marp) - Need WYSIWYG editing (use Word directly) - Converting complex nested HTML (may lose formatting) ## Prerequisites ### Installation ```bash # macOS (Homebrew) brew install pandoc brew install pandoc-crossref # For cross-references brew install basictex # Minimal LaTeX for PDF # Or full LaTeX: brew install --cask mactex # Ubuntu/Debian sudo apt-get update sudo apt-get install pandoc pandoc-citeproc *See sub-skills for full details.* ### System Requirements - Pandoc 2.19 or higher (3.x recommended) - LaTeX distribution (for PDF output) - Python 3.8+ (for pandoc-filters) ## Version History ### v1.0.0 (2026-01-17) - Initial skill creation - PDF, DOCX, HTML conversion workflows - Custom LaTeX templates - Citation management with BibTeX/CSL - Cross-references with pandoc-crossref - Lua filters documentation - Batch conversion scripts - Makefile integration - GitHub Actions workflows ## Sub-Skills - [1. Basic Format Conversion (+3)](1-basic-format-conversion/SKILL.md) - [5. Custom LaTeX Templates (+1)](5-custom-latex-templates/SKILL.md) - [7. Citations and Bibliography (+1)](7-citations-and-bibliography/SKILL.md) - [9. Lua Filters](9-lua-filters/SKILL.md) - [10. Batch Conversion Scripts](10-batch-conversion-scripts/SKILL.md) - [11. Makefile for Document Projects (+1)](11-makefile-for-document-projects/SKILL.md) - [Integration with Git Hooks (+1)](integration-with-git-hooks/SKILL.md) - [1. Document Structure](1-document-structure/SKILL.md) - [Common Issues (+1)](common-issues/SKILL.md) ## Sub-Skills - [Background](background/SKILL.md) - [Subsection](subsection/SKILL.md) - [2. Image Management (+2)](2-image-management/SKILL.md) - [Related Resources](related-resources/SKILL.md)
Related Skills
baoyu-article-illustrator
Article illustrations: type × style × palette consistency.
vscode-extensions
VS Code productivity optimization with essential extensions, settings sync, profiles, keybindings, snippets, and workspace configuration
git-advanced
Advanced git workflows including rebase, worktrees, bisect, hooks, and monorepo patterns
docker
Complete Docker containerization patterns with multi-stage builds for development and production workflows
elite-frontend-ux
Create distinctive, production-grade frontend interfaces with expert-level UX design. Use when building SaaS dashboards, landing pages, marketing sites, React/Vue components, HTML/CSS layouts, or any web UI. Combines bold aesthetic direction with systematic design tokens, WCAG accessibility, conversion optimization, and Tailwind/React best practices. Produces polished, memorable interfaces that avoid generic AI aesthetics while meeting professional standards. type: reference
sphinx
Generate comprehensive Python documentation with Sphinx. Covers autodoc for API extraction, Napoleon for Google/NumPy docstrings, intersphinx for cross-references, and multiple output formats including HTML, PDF, and ePub.
marp
Create professional Markdown-based slide presentations with Marp. Covers themes, directives, speaker notes, presenter view, and export to PDF, HTML, and PPTX formats. Includes VS Code integration, CLI usage, and CI/CD automation.
docusaurus
Build modern documentation websites with Docusaurus. Covers docs, blog, pages, versioning, i18n, search integration, and deployment patterns. React-based with MDX support for interactive documentation.
slack-api
Slack bot development and workspace automation using Web API, Events API, Socket Mode, and Block Kit for building interactive messaging applications
miro-api
Miro whiteboard automation using REST API v2 and Python SDK for creating boards, frames, shapes, connectors, and collaborative visual workflows
calendly-api
Calendly scheduling automation using REST API v2 for managing event types, availability, bookings, webhooks, and scheduling workflows
mkdocs
Build professional project documentation with MkDocs and Material theme. Covers site configuration, navigation, plugins, search optimization, versioning with mike, and deployment to GitHub Pages.