markdown-to-pdf

Converts a markdown file to a professionally formatted PDF. Pure Python — no system tools required.

Dependencies

Requires two Python packages (already in pyproject.toml):

mistune>=3.2
reportlab>=4.0

Install with: uv sync (or pip install mistune reportlab)

Instructions

uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py <input.md> [output.pdf]

• input.md — path to the markdown file (required)
• output.pdf — output path (optional; defaults to same directory and basename as input)

Output

The script returns JSON with:

• success — true or false
• input — resolved absolute path of the input file
• output — resolved absolute path of the generated PDF
• error — error message if success is false
• generated_at — NY timezone timestamp
• data_delay — always "real-time"

After conversion, tell the user the output PDF path.

Examples

# Convert sandbox/report.md → sandbox/report.pdf (default output)
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md

# Explicit output path
uv run python .claude/skills/markdown-to-pdf/scripts/markdown_to_pdf.py sandbox/report.md sandbox/AAPL_Report_2026-05-20_1430.pdf

Supported Markdown

• Headings (H1–H3)
• Paragraphs, bold, italic
• Tables (pipe syntax)
• Fenced code blocks
• Unordered and ordered lists