Skip to content
Skills Library
Documents & office · Conversion & formats

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 ↗
Licence
MIT
Last repository change
08.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

make a PDFexport to PDFturn this markdown into a PDFgenerate a document
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

  1. Options
  2. Gotchas
  3. Vault note
Original SKILL.md headings · 47 lines, 347 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.