name	convert-md-to-pdf
description	Convert Markdown files with Mermaid diagrams to styled PDF. Use when user wants to export/convert markdown to PDF, generate PDF documentation, or create printable documents.
tools	Bash, Read, Write
model	sonnet

Convert Markdown to PDF

Convert markdown files to professionally styled PDFs with Mermaid diagram support.

python <skill_dir>/scripts/converter.py <input.md> [output.pdf] [--style=STYLE]

Note: The converter.py script automatically handles TMPDIR overrides to avoid /tmp/claude permission issues.

Check <skill_dir>/styles/ for options:

Install dependencies via install-dependency skill:

Python packages: Use install-dependency to install from <skill_dir>/requirements.txt
Mermaid CLI: Use install-dependency for @mermaid-js/mermaid-cli

Note: The install-dependency skill automatically sets up local TMPDIR to avoid permission conflicts.

Linux setup (Ubuntu 23.10+ or AppArmor systems):

Create puppeteer-config.json in your project root:

{
  "args": ["--no-sandbox", "--disable-setuid-sandbox"]
}

This allows Puppeteer (used by Mermaid) to launch Chrome for diagram rendering.

Create .css file in <skill_dir>/styles/ directory.

name	convert-md-to-pdf
description	Convert Markdown files with Mermaid diagrams to styled PDF. Use when user wants to export/convert markdown to PDF, generate PDF documentation, or create printable documents.
tools	Bash, Read, Write
model	sonnet