markpdf

Beautiful PDFs from markdown. One command, zero config.

markpdf report.md

Install

Agent skill (Claude Code, Cursor, Codex, Gemini CLI):

npx skills add araa47/markpdf

CLI:

uv tool install git+https://github.com/araa47/markpdf

Usage

markpdf report.md                        # creates report.pdf
markpdf report.md --dark                  # dark mode
markpdf report.md -o final.pdf            # custom output path
markpdf report.md -k                      # keep sections on same page

Output

Light	Dark

Source: tests/fixtures/showcase.md | Full PDFs: examples/

Why markpdf?

Most messaging apps (Slack, Discord, Teams, WhatsApp, email) don't render markdown. markpdf turns it into a polished PDF — no browser, no LaTeX, no config.

• Full markdown — headers, lists, tables, code blocks, blockquotes, images, task lists
• Extended syntax — ==highlight==, ^super^, ~sub~, ~~strike~~
• Light & dark themes — shadcn/ui zinc palette
• Remote images fetched concurrently
• Async I/O with optional uvloop
• Single binary-style command, agent-friendly