convert-md-to-pdf

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.

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.