---
name: ulk-pandoc
description: "Convert documents between formats using Pandoc. Use for MD to PDF/DOCX/HTML, DOCX to MD, and other document conversions. Useful for spec-writer and documentalist agents."
---

# Pandoc (Document Converter)

## Prerequisite
Verify: `command -v pandoc`
If absent:
- macOS: `brew install pandoc`
- Linux: `apt install pandoc`

## Markdown Conversions
```bash
pandoc spec.md -o spec.pdf                 # MD → PDF (requires LaTeX)
pandoc spec.md -o spec.docx                # MD → DOCX
pandoc README.md -t html -s -o readme.html # MD → HTML (standalone)
```

## Reverse Conversions
```bash
pandoc input.docx -t markdown -o output.md # DOCX → MD
pandoc page.html -t markdown -o page.md    # HTML → MD
```

## With Metadata
```bash
pandoc spec.md -o spec.pdf \
  --metadata title="Project Spec" \
  --metadata author="Team" \
  --metadata date="$(date +%Y-%m-%d)"
```

## With Templates
```bash
pandoc spec.md -o spec.pdf --template=template.tex
pandoc spec.md -o spec.html --template=template.html
```

## Batch Conversion
```bash
# Convert all .md files in docs/ to HTML
for f in docs/*.md; do
  pandoc "$f" -t html -s -o "${f%.md}.html"
done
```