How to Convert Markdown to PDF
Four proven methods — from a zero-setup online converter to fully scripted Pandoc builds — and when to use each.
1. Free online converter (fastest)
Paste your Markdown into a browser-based converter and download the PDF. The MarkdownTools Markdown to PDF converter renders everything locally — nothing is uploaded — with themes, page size and margin options, and templates for common documents. Best when you want a polished PDF in under a minute.
Best for: One-off exports, polished output without installing anything
2. VS Code extension
If you already write Markdown in VS Code, the "Markdown PDF" extension adds a right-click export. Convenient inside your editor, though styling options are more limited and each machine needs the extension installed.
Best for: Developers who live in VS Code
3. Pandoc (command line)
Pandoc is the reference document converter: "pandoc notes.md -o notes.pdf". It produces beautiful, fully controllable output via LaTeX templates — at the cost of installing Pandoc plus a LaTeX distribution, which is a sizeable setup. The right choice for automated builds and academic documents.
Best for: Automation, CI pipelines, and citation-heavy documents
4. Your Markdown app's built-in export
Obsidian, Typora, and most note apps can export a note to PDF directly (often via Ctrl/Cmd+P and "Save as PDF"). Zero extra tools, but output styling follows the app's theme and complex elements like Mermaid diagrams vary by app.
Best for: Quick exports of notes you already keep in one app
Which method should you pick?
For a document you need right now, the online converter wins: no setup and consistent, themed output. For a repeatable publishing workflow — release notes, reports, documentation built in CI — invest the setup time in Pandoc. If you mostly export the occasional note, whatever app you write in probably already does the job. Before exporting, run your document through the Markdown linter to catch broken tables and heading issues that show up much more visibly in a PDF.