Convert Markdown to PDF

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

Usage

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.

Available Styles

Check <skill_dir>/styles/ for options:

• default - Clean sans-serif, professional
• modern - Bold headers, accent colors
• minimal - Serif font, whitespace
• report - Formal corporate style

First Run

Install dependencies via install-dependency skill:

1. Python packages: Use install-dependency to install from <skill_dir>/requirements.txt
2. 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.

Adding Styles

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