About pandoc-converter
Pandoc Converter is a skill for converting documents between common formats through Pandoc. It supports document conversions, read-only input for tabular data, and options such as tables of contents and PDF engines.
Key features
- 01Convert between common document formats
- 02Read CSV, TSV, and XLSX as input
- 03Support GFM and CommonMark variants
- 04Set input and output formats
- 05Add standalone headers and table of contents
- 06Pass through Pandoc options
Use cases
- 01Convert Markdown files to DOCX, PDF, or HTML
- 02Convert DOCX documents to Markdown
- 03Turn CSV data into HTML tables
- 04Convert LaTeX documents to PDF
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ jrajasekera/ jr-agent-skills --skill pandoc-converterAfter installing, type/pandoc-converterin Claude Code to confirm it loaded.
Bundled filesreferences/format-compatibility.mdscripts/convert.py
Details
From the project READMEPandoc Converter
Convert documents between common formats using Pandoc.
Quick Start
# Basic conversion (format auto-detected from extensions)
python scripts/convert.py input.md output.docx
# Specify output format only
python scripts/convert.py document.md --to html
# Check if Pandoc is installed
python scripts/convert.py --check
# List supported formats
python scripts/convert.py --formats
Supported Formats
Document formats (read/write): markdown, html, docx, latex, epub, rtf, pptx, pdf
Data formats (read only): csv, tsv, xlsx
Markdown variants: gfm (GitHub), commonmark
For detailed compatibility, see references/format-compatibility.md.
Common Conversions
| From | To | Command |
|---|---|---|
| Markdown | Word | python scripts/convert.py doc.md doc.docx |
| Markdown | python scripts/convert.py doc.md doc.pdf | |
| Markdown | HTML | python scripts/convert.py doc.md doc.html |
| Word | Markdown | python scripts/convert.py doc.docx doc.md |
| CSV | HTML table | python scripts/convert.py data.csv data.html |
| LaTeX | python scripts/convert.py paper.tex paper.pdf |
Options
| Option | Description |
|---|---|
--from <fmt> | Override input format detection |
--to <fmt> | Specify output format (if no output file) |
--standalone | Include document headers/footers |
--toc | Add table of contents |
--pdf-engine <eng> | PDF engine: pdflatex, xelatex, lualatex |
Additional Pandoc options pass through directly.
Workflow
- Check installation: Run
python scripts/convert.py --check - If not installed: Follow the installation instructions provided
- Convert: Run the conversion with input and output files
- Present result: Provide the converted file to the user
Installation (if needed)
The script provides installation guidance, but here's a summary:
# macOS
brew install pandoc
# Ubuntu/Debian
sudo apt-get install pandoc
# For PDF output, also install LaTeX:
# macOS: brew install --cask mactex-no-gui
# Ubuntu: sudo apt-get install texlive-xetex
Limitations
- CSV/TSV/XLSX: Input only (converts to tables in other formats)
- PDF output: Requires LaTeX installation
- PPTX: Text extraction works; complex layouts may simplify
- Complex formatting: Some features may not transfer between formats