- name
- markdown-to-pdf
- description
- Convert a markdown file to PDF using mistune + reportlab. Use when the user wants to convert a .md file to PDF, or when another skill needs to produce a PDF from markdown output.
- user_invocable
- true
- arguments
- - name: file description: Path to the input markdown file required: true - name: output description: Output PDF path. Defaults to same directory and basename as the input file. required: false
- dependencies
- ["trading-skills"]
Markdown to PDF Converter
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—trueorfalseinput— resolved absolute path of the input fileoutput— resolved absolute path of the generated PDFerror— error message ifsuccessisfalsegenerated_at— NY timezone timestampdata_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
- Images:
with a local JPG or PNG, relative to the markdown file or absolute. Each is scaled down to fit the page width and three quarters of its height, keeping its aspect ratio. A missing file or a remote URL shows instead.