markdown-to-pdflisted

# markdown-to-pdf Turn a Markdown file into a plain, print-grade PDF where every hyperlink stays clickable, pipe tables become real tables, and ```mermaid fences are rendered locally (no network) and embedded as diagrams. Output reads as an internal working document: no cover page, no table of contents, no brand tokens. For the polished branded look use `branded-docx`; for e-reader output use `markdown-to-epub`. ## Why this exists Three converters were converged into this one. A reportlab briefing renderer had clickable links but printed tables as raw pipe characters. A headless-Chrome print script had beautiful tables and Mermaid but produced PDFs with zero /URI link annotations (measured; no Chrome flag fixes it). This skill keeps the winning half of each: one reportlab engine with links everywhere (including inside table cells), tables, Mermaid via local mermaid-cli, and the proven header/footer stamp scheme (Page N of M top-left, version and date top-right, and one audience-chosen value centered in the footer: the source filename when printing your own research, your contact when sending a deliverable). ## Step 0 - dependencies The script carries a PEP 723 header, so `uv run` resolves Python deps (markdown, reportlab, pillow) automatically. Without uv: `pip install "markdown>=3.6" "reportlab>=4" pillow` and run with plain `python`. mermaid-cli is required ONLY when the document contains mermaid fences: `npm install -g @mermaid-js/mermaid-cli`. Documents without diag