Markdown documents are easy to write but awkward to share with people who do not use markdown tools. Converting to PDF gives you a file anyone can open, print, and read with formatting intact. This guide compares the three main routes.
Route one: the browser print dialog
Open your markdown in a previewer, then use the browser’s print function and choose “Save as PDF”. This is the fastest route and needs no software. It works well for short documents, but page breaks, headers, and footers are limited, and long documents may split tables or code blocks awkwardly across pages.
Route two: a dedicated converter
Online converters take your markdown and return a PDF, often with themes, table of contents, and better page control. This is the best route for documents you will share widely. Check the result before sending: code blocks, tables, and images are the parts most likely to render differently than you expect.
Route three: Pandoc and local tools
Pandoc is a free command-line tool that converts markdown to PDF with full control over styling, margins, and metadata. It needs installation and a PDF engine, so it suits people who convert documents regularly. The payoff is consistent, professional output and automation: a whole folder of documents can be converted with one command.
Step-by-step: a reliable conversion
- Preview your markdown first and fix rendering problems before converting.
- Check images: make sure every image path works and every image is sized sensibly.
- Check tables: wide tables overflow PDF pages, so shorten columns or split tables.
- Pick your route based on the document: print dialog for quick drafts, converter for sharing, Pandoc for repeated work.
- Convert, then read the PDF end to end. Check page breaks, code blocks, and the final page.
- Fix problems in the markdown, not in the PDF, so the source stays correct.
Common problems
Code blocks that run past the page edge, tables that overflow, and images that land on their own page are the usual complaints. Shorter lines in code, narrower tables, and smaller images fix most of them. Fonts are another trap: a PDF made on one machine may substitute fonts on another unless they are embedded.
Try it the faster way
Convert your markdown to PDF with the tool below.
Prefer the full page? Open the markdown to PDF converter directly.
Quick tips
- Always preview markdown before converting; conversion preserves errors faithfully.
- Fix layout problems in the source, not in the output file.
- For repeated conversions, invest in Pandoc once and reuse it forever.
Markdown to PDF is a solved problem with three good routes. Pick the simplest one that fits the document, check the output, and fix the source when something looks off.
Frequently asked questions
Will my PDF look exactly like the markdown preview? Usually close, but not identical. Page size, margins, fonts, and page breaks differ between preview and PDF. Always read the PDF itself before sharing, rather than trusting the preview.
How do I add page numbers or headers to the PDF? Browser print dialogs offer basic headers and footers, but for full control use Pandoc with a template, where you can set page numbers, running headers, and a title page. Online converters vary: check their options before converting.
What happens to links in the PDF? Most converters preserve links as clickable, but some render them as plain text with the address shown. If clickable links matter, test one link in the output before distributing the document.
Worked example
Take a short markdown report: a title, two sections, a small table, and one code block. Through the browser print dialog, it becomes a decent PDF in under a minute, but the code block may split across a page break. Through a dedicated converter, you get a styled PDF with a table of contents and better break control. Through Pandoc, you set margins, fonts, and headers once, then convert every future report identically. The right route depends on whether this is a one-off share or a document you will produce weekly.