How to Convert Markdown to PDF for Free
Markdown has become the lingua franca of technical writing, documentation, note-taking, and developer communication. It's clean, readable as raw text, and converts beautifully to formatted HTML or PDF. But converting a .md file to a well-formatted PDF isn't always as straightforward as the conversion itself — the styling, page breaks, code block rendering, and image handling vary significantly between conversion methods. There are several approaches to Markdown-to-PDF conversion, each with different trade-offs in terms of styling control, ease of use, and output quality. Whether you're exporting API documentation, sharing a technical proposal, creating a formatted report from your notes, or producing a resume written in Markdown, this guide helps you choose the right method and get clean output. All the methods covered here are free — some require a desktop application or command-line tool, while others work entirely in a browser.
Method 1: Markdown to HTML to PDF
The most flexible approach is a two-step conversion: first convert Markdown to HTML (preserving all formatting, code blocks, lists, and headings), then convert the HTML to PDF. This gives you the most control over styling because you can apply a CSS stylesheet to the HTML before converting to PDF. Markdown-to-HTML conversion tools include Pandoc (command line, handles most Markdown extensions), online converters like Dillinger.io (browser-based), and static site generators. Once you have styled HTML, LazyPDF's HTML-to-PDF tool converts it to a formatted PDF. For clean, consistent styling, create or download a print-optimized CSS file that handles code blocks, tables, blockquotes, and typography in a way that looks good on paper. The combination of Pandoc for conversion and a quality CSS stylesheet for styling produces the best results for technical documentation.
- 1Paste your Markdown into an online editor like Dillinger.io or use Pandoc to convert to HTML.
- 2Add a print-optimized CSS stylesheet to style code blocks, tables, and headings.
- 3Copy the complete HTML (with embedded CSS) and use LazyPDF's HTML-to-PDF tool.
- 4Download the resulting PDF and verify that code blocks, tables, and images render correctly.
Method 2: VS Code with PDF Export Extension
Visual Studio Code is the most popular editor for Markdown files, and its extension ecosystem includes excellent Markdown-to-PDF converters. The 'Markdown PDF' extension by yzane is the most widely used — it adds a right-click 'Export (pdf)' option to any Markdown file. It uses Chromium headless browser rendering under the hood, which produces high-quality output that accurately renders GitHub Flavored Markdown including tables, task lists, strikethrough, and fenced code blocks with syntax highlighting. Install the extension from VS Code's extension marketplace, open your .md file, right-click in the editor, and select 'Markdown PDF: Export (pdf)'. The output PDF appears in the same directory as your source file. You can customize the output by adding a CSS file to the extension settings — useful for adjusting fonts, page margins, code block styling, and print-specific formatting. This method works fully offline and handles most Markdown features correctly.
Method 3: Pandoc Command Line
Pandoc is the Swiss Army knife of document format conversion and handles Markdown to PDF with high-quality output. It requires LaTeX for PDF output (a large installation) but alternatively can use its wkhtmltopdf or weasyprint backends for HTML-based PDF generation, which are smaller dependencies. Pandoc supports an enormous range of Markdown extensions and produces professionally formatted output with full control over styling via templates. The basic command is `pandoc input.md -o output.pdf`. For HTML-based PDF (no LaTeX required): `pandoc input.md -o output.pdf --pdf-engine=wkhtmltopdf`. Pandoc supports YAML front matter in Markdown files for specifying title, author, date, and document metadata that appear in the PDF. For technical documentation with academic citations, equations (via LaTeX math), and complex tables, Pandoc with LaTeX is the most powerful available option — though the installation is more involved.
Getting the Best Styling for Markdown PDFs
The default styling of most Markdown-to-PDF tools is functional but not beautiful. Improving the visual quality of your output significantly improves how it's received, especially for client-facing documents. Key areas to address with CSS: set readable font sizes (11–12pt for body text), use a font stack that includes good code fonts (like JetBrains Mono or Fira Code for code blocks), set page margins generously (at least 1 inch on all sides), add page breaks before H1 headings to separate major sections, and style tables with clear borders and alternating row colors for readability. For Markdown-based resumes, templates specifically designed for resume-to-PDF conversion are available as open-source projects. These handle the specific layout requirements of resumes (compact, clean, no extra whitespace) better than generic Markdown PDF styles. Search for 'Markdown resume template' on GitHub for curated options with print-optimized CSS.
Frequently Asked Questions
Does LazyPDF convert Markdown to PDF directly?
LazyPDF's HTML-to-PDF tool doesn't accept .md files directly, but you can convert Markdown to HTML first using any online Markdown-to-HTML converter, then pass the resulting HTML to LazyPDF's HTML-to-PDF tool. Alternatively, use LazyPDF's word-to-pdf tool if you paste your Markdown content into a Word document first. For direct .md file conversion, VS Code with the Markdown PDF extension or Pandoc from the command line are the most convenient direct approaches.
How do I preserve code syntax highlighting in a Markdown PDF?
Syntax highlighting in Markdown PDF output depends on the conversion tool's code rendering. Pandoc supports syntax highlighting via the --highlight-style flag, with many built-in themes. VS Code's Markdown PDF extension uses Chromium rendering which applies the same highlighting as your VS Code theme. For browser-based HTML-to-PDF conversion, embed a syntax highlighting CSS library (like highlight.js stylesheet) in your HTML before converting to PDF. Without explicit syntax highlighting CSS, code blocks will render as monospace plain text.
Can I convert GitHub README files to PDF?
Yes. GitHub renders README.md files as HTML on the repository page. You can use your browser's print-to-PDF feature on the rendered GitHub page to capture it as PDF (the output includes GitHub's styling). Alternatively, copy the raw Markdown content and convert it using your preferred method. For cleaner output without GitHub's navigation and sidebar, use GitHub's raw file URL to get just the Markdown content, then convert through any Markdown-to-PDF tool.