How to convert Markdown to PDF
Turn a Markdown document into a clean, shareable PDF entirely in your browser — what carries over, how page breaks work, and how to check pagination before you send.
Markdown is perfect for writing and terrible for sending to someone who just wants to read it. A PDF fixes that: it looks the same on every device, prints predictably, and needs no special software. The Markdown to PDF tool does the conversion in your browser — the file never leaves your machine.
How the conversion works
The tool renders your Markdown to clean, styled HTML, then hands that to the browser's own print engine to produce the PDF. That second step matters: it means the output uses the same high-quality text rendering as printing any web page, so headings, code blocks, tables, and lists all come through as crisp, selectable text — not a flattened image.
What carries over
- Headings become sized, bold section titles.
- Code blocks keep their monospace font and spacing.
- Tables render as real bordered tables.
- Lists, quotes, bold, and links all survive (links stay clickable in most viewers).
What doesn't carry over is anything interactive: there's no such thing as a collapsible section or a running script in a PDF. Mermaid diagrams and images render as static pictures.
Page breaks and pagination
A PDF has pages; a Markdown file doesn't. The browser decides where to break, and it tries not to split a heading from the paragraph beneath it. Two habits keep your output tidy:
- Preview before you save. In the print dialog, scan the page thumbnails for an orphaned heading at the bottom of a page or a table split awkwardly across two.
- Keep code blocks short. A 60-line code block that lands mid-page will break across the boundary. If a block must stay whole, move it so it starts near the top of a page.
When a PDF is the right call
Reach for PDF when the reader shouldn't edit the content: a résumé, a one-pager sent to a client, release notes attached to an email, or a printout for a meeting. When the reader should be able to copy or change the text, send the Markdown itself, or use Markdown to Word instead.
For everything else — a clean, fixed snapshot of what you wrote — paste, preview, save.