How to Convert Markdown to PDF (README, Notes, and Docs)

Markdown is great for writing — READMEs, notes, documentation, quick drafts — but it's not something you can hand to someone who just wants to read a finished document. Converting it to PDF turns # Heading and **bold** into an actual formatted page, without needing a static site generator or a full documentation pipeline for a single file.

What Gets Rendered

QR Ivify's Markdown to PDF tool supports standard Markdown plus the GitHub-flavored extensions most people actually use:

• Headings (# through ####)
• Paragraphs, bold, and italic
• Links
• Ordered and unordered lists
• Code blocks and inline code
• Blockquotes
• Tables (GitHub-flavored, pipe-delimited)
• Horizontal rules

If you've written a README on GitHub before, the syntax you already know works here without changes.

Step by Step

1. Open the Markdown to PDF converter.
2. Write or paste your Markdown into the editor on the left — a sample is pre-filled to show the format.
3. Watch the live preview on the right update as you type.
4. Choose page size, orientation, and margins.
5. Click "Convert to PDF" and download the result.

On mobile, the editor and preview stack vertically instead of side by side, so you can still see both without a wide screen.

Raw HTML Inside Markdown

Markdown technically allows you to drop raw HTML directly into the document — this is a real, documented part of the spec, not an edge case. Since that HTML could theoretically include something unsafe (a script tag, an event handler), any embedded HTML is sanitized the same way this site's HTML to PDF converter sanitizes pasted HTML, before it's ever rendered. Your formatting still works; anything that could execute code doesn't.

Tables in Markdown

GitHub-flavored tables use pipes and a separator row:

| Column A | Column B |
| --- | --- |
| 1   | 2   |

These render as real bordered tables in the output PDF — useful for anything from a comparison chart to a simple data summary, without needing to switch to a spreadsheet tool for something small.

What Doesn't Carry Over

• The output PDF's text isn't selectable. Rendering goes through the same image-based pipeline as this site's Word to PDF converter — a deliberate trade-off that's what makes Vietnamese and other Unicode text, plus more complex formatting like tables and code blocks, render correctly and consistently.
• Markdown extensions beyond GFM (footnotes, custom containers, math syntax from less common Markdown flavors) aren't guaranteed to render — stick to standard and GitHub-flavored syntax for predictable results.

Common Uses

• Turning a project's README into a shareable PDF for someone who isn't going to clone the repo.
• Exporting notes or a proposal written in Markdown into a document you can email or print.
• Quickly previewing how GitHub-flavored Markdown will look formatted, before pasting it somewhere else.

Common Problems

A table didn't render as a table. Check that you have the separator row (the line of dashes, like | --- | --- |) directly under the header row — that's what GitHub-flavored Markdown uses to recognize a table versus a line that happens to contain pipe characters.

Raw HTML I embedded didn't show up as expected. If it included a script tag or an event handler attribute, that part is intentionally removed. Standard formatting tags in embedded HTML still render normally.

The preview looks right but I want to double check before converting. That's exactly what the live preview is for — it uses the same rendering path as the final PDF, so what you see is what you'll get.

Frequently Asked Questions

Does this support GitHub-flavored tables? Yes — pipe-delimited tables, along with headings, lists, code blocks, blockquotes, and horizontal rules, are all supported.

Is raw HTML inside my Markdown safe? Yes — any HTML embedded in the Markdown is sanitized the same way as this site's HTML to PDF tool, before it's ever rendered, so scripts can't run.

Does this support Vietnamese and other Unicode text? Yes — content renders through your browser's own font engine, so Vietnamese and other Unicode text display correctly.

Can I control the page layout? Yes — page size (A4/Letter), orientation, and margins are all adjustable before converting.

Does this upload my Markdown anywhere? No — parsing and rendering both happen entirely in your browser. See our guide to online converter safety for what to check on any tool.

Try It

Need to turn a README, notes, or Markdown-written docs into a shareable PDF? QR Ivify's free Markdown to PDF converter has a live preview and full GitHub-flavored Markdown support. Working from plain text instead? Try TXT to PDF; from raw HTML, see HTML to PDF.