make-pdf
/make-pdf
Turn a markdown file into a publication-quality PDF — cover page, clickable table of contents with page numbers, running headers, page numbers, curly quotes, syntax-highlighted code, optional DRAFT watermark. Use when asked to "make a PDF", "export to PDF", "turn this markdown into a PDF", or "generate a document".
- Author
- sejas ↗
- Repository
- ai-code-skills ↗
- Licence
- MIT
- Last repository change
- 08.10.2026
Assessment and security
- Files in this package
- 2
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: md2pdf.py
What it does and when to use it
Turn a markdown file into a publication-quality PDF — cover page, clickable table of contents with page numbers, running headers, page numbers, curly quotes, syntax-highlighted code, optional DRAFT watermark. Use when asked to "make a PDF", "export to PDF", "turn this markdown into a PDF", or "generate a document".
Triggers from the description
Original author description
Turn a markdown file into a publication-quality PDF — cover page, clickable table of contents with page numbers, running headers, page numbers, curly quotes, syntax-highlighted code, optional DRAFT watermark. Use when asked to "make a PDF", "export to PDF", "turn this markdown into a PDF", or "generate a document".
How it works
- Options
- Gotchas
- Vault note
SKILL.md preview
--- name: make-pdf description: Turn a markdown file into a publication-quality PDF — cover page, clickable table of contents with page numbers, running headers, page numbers, curly quotes, syntax-highlighted code, optional DRAFT watermark. Use when asked to "make a PDF", "export to PDF", "turn this markdown into a PDF", or "generate a document". allowed-tools: Bash, Read, AskUserQuestion --- # make-pdf ```bash uv run --quiet --with weasyprint --with markdown --with pygments \ ~/.claude/skills/make-pdf/md2pdf.py INPUT.md ``` Writes `INPUT.pdf` next to the input and prints the path. Then `open` it, or read it back with the Read tool to check the result before handing it over. ## Options | Flag | Effect | |---|---| | `-o OUT.pdf` | Output path (default: input path with `.pdf`) | | `--title` / `--subtitle` / `--author` | Override the cover; otherwise taken from YAML front matter, then the first `# H1`, then the filename | | `--draft` | Diagonal DRAFT watermark on every page | | `--no-cover` | Skip the cover page | | `--no-toc` | Skip the table of contents | Front matter (`title`, `subtitle`/`description`, `author`, `date`) is consumed for the cover and stripped from the body. A leading `# H1` that repeats the title is dropped so the cover doesn't say it twice. ## Gotchas - **Needs `uv` and Homebrew `pango`.** WeasyPrint links against pango at runtime; without it the import fails with a `libgobject`/`libpango` load error — fix with `brew install pango`. `uv run --with` builds a cached ephemeral env, so nothing is installed globally and the first run takes ~10s, later ones ~2s. - **WeasyPrint, not headless Chrome, on purpose.** Running headers, `counter(page)`, and the TOC's page numbers are `@page` margin boxes and `target-counter()`. Chrome ignores both, so a Chrome-based pipeline silently drops exactly the features that make the output look printed. - **Relative image paths resolve against the markdown file's directory.** Images from elsewhere need absolute paths. - **Mermaid and other JS-rendered diagrams don't render** — there is no JS engine in the pipeline. Convert them to SVG/PNG first and reference the image. - Everything visual lives in one `STYLESHEET` string at the top of `md2pdf.py`. For a different look, edit it there — there is no theme system and no config file. ## Vault note For a note out of the Obsidian vault, wikilinks (`[[slug]]`) pass through as literal text — strip or expand them first if the PDF is going to someone outside the vault.
Files in this package (2)
- SKILL.md 2 KB
- md2pdf.py 9 KB
Versions
The database has no other skills named make-pdf.
Database snapshot: 13.11.2026 · package version 93d87af919d8 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100markdown-to-pdf
Use when converting a Markdown file into a beautiful, print-ready PDF — reports, docs, specs, or exports with a styled cover page, running headers/footers, page numbers, tables, syntax-highlighted code, and mermaid diagrams. - 100markdown-to-pdf
Use when asked to turn a Markdown file into a PDF, export a .md report for printing or sharing, or produce a printable deliverable from Markdown, especially documents containing mermaid diagrams, wide tables, or that need page numbers and a running header. - 100md-to-pdf
Convert any markdown file to a clean PDF. Use when asked to make a PDF from a .md file, export a document, or convert markdown to PDF. - 100markdown-to-pdf
Use when the user runs /markdown-to-pdf on Markdown to render a publication-quality PDF. Not for remote, credential, publish, deploy, or irreversible changes. - 96markdown-pdf-pipeline
Use when rendering a tutorial or report PDF from Markdown. - 95lov-any2docx
Convert Markdown documents to professionally styled DOCX (Word) files with python-docx. Handles CJK/Latin mixed text, fenced code blocks, tables, blockquotes, cover pages, TOC field, watermarks, and page numbers. Supports multiple color themes matching any2pdf (Configurable…