I write everything in markdown. Specs, proposals, reports, the occasional
essay. And for years I've hit the same wall: getting markdown out as a
PDF that doesn't look like a 2009 browser printout.
I went deep on this — tried every method I could find — and ended up
building a tool to fix it. Here's the honest comparison of all 8 ways to
turn markdown into a PDF, ranked by how much pain each one costs you.
1. Browser print (Cmd+P → Save as PDF)
Free, instant, and looks like it. No control over typography, page breaks
land wherever, code blocks get clipped. Fine for a throwaway. Embarrassing
for anything you hand to a client.
2. Pandoc + default LaTeX
The quality ceiling is high. The floor is a weekend of YAML and template
debugging. pandoc input.md -o output.pdf works until you want it to look
like anything specific — then you're learning LaTeX.
3. Pandoc + Eisvogel template
Eisvogel is the best free markdown→PDF template out there. Genuinely good
output. You still need a working LaTeX install (~4GB) and comfort on the
command line.
4. md-to-pdf (npm)
npx md-to-pdf input.md. Chromium under the hood, so it's really
HTML-to-PDF. Decent for code-heavy docs, weak on print typography.
5. VS Code "Markdown PDF" extension
Convenient if you live in VS Code. Same Chromium engine, same limitations.
6. Marked 2 (Mac)
$13.99, lovely live preview, solid export. Mac-only, no templates beyond a
handful of CSS themes, no AI, no cloud library.
7. Online converters (markdowntopdf.com, CloudConvert)
Zero setup. Generic output, often watermarked, and you're uploading your
document to someone's server.
8. The one I built — mdclaudy
Full disclosure: this is mine, so weigh accordingly. After all the above,
I wanted Pandoc-grade output without the Pandoc tax. mdclaudy gives you 15
hand-designed templates, exports to PDF and DOCX, keeps markdown as the
source of truth, and has an optional AI layer for drafting. Free tier, no
card.
The honest verdict: if you're a developer who already has LaTeX
installed and enjoys the control, Pandoc + Eisvogel is hard to beat for
free. If you want a designed document without the setup, that's the gap I
built mdclaudy to fill.
Full version with screenshots of each method's output:
https://mdclaudy.com/blog/markdown-to-pdf
What's your markdown→PDF setup? Always looking for methods I missed.
