awesome-md-to-pdf

Awesome editorial Markdown to PDF. Convert a directory of Markdown files into beautifully styled PDFs with a Claude/Anthropic-inspired default design or any DESIGN.md that follows Google’s DESIGN.md spec.

Get started now View on GitHub

Preview

PDF rendered with the Linear design, light mode
Linear design, light mode
PDF rendered with the Linear design, dark mode
Linear design, dark mode

Install 

npm install -g awesome-md-to-pdf

Or run without installing:

npx awesome-md-to-pdf docs

First run 

# Interactive chat mode -- the 3D banner lands you in a slash-command REPL
awesome-md-to-pdf

# Or one-shot
awesome-md-to-pdf ./my-notes -o ./pdf --toc --cover --mode light

Why this exists

Most Markdown-to-PDF tools produce either CMS-grade corporate output or plain HTML-print. awesome-md-to-pdf aims for something rarer: editorial typography that feels published. Warm parchment canvas, serif headlines, ring-based depth, terracotta accents. You can swap in any spec-compliant DESIGN.md and the output re-themes itself: colors, typography, rounded corners, spacing, and component styling all flow from the file’s YAML frontmatter.

What’s inside

  • Chat mode – slash commands, ghost hints, live progress bars.
  • One-shot CLI – scriptable flags for CI pipelines.
  • Designs – spec-compliant DESIGN.md parsing, the token surface, and how to author your own.
  • Themes & modes – light, dark, accent overrides.
  • Markdown features – everything from Mermaid to KaTeX to task lists.
  • Architecture – module map of the src/ tree.
  • Troubleshooting – Puppeteer, fonts, mermaid, and banner caveats.

License

MIT.