Agent skill

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.

Stars 4
Forks 4

Install this agent skill to your Project

npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/development/documentation/pandoc

SKILL.md

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)

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results