How Do You Convert Markdown to PDF?
You convert Markdown to PDF by adding an MD file to QuickCatPDF's Markdown to PDF converter, or pasting the Markdown into Type or paste, and clicking Download PDF. Headings, lists, tables, task lists, links, pictures and code blocks are turned into a clean document with bookmarks and page numbers.
Save as PDF on this device builds the same document in your browser and opens the print window, so the file isn't uploaded. It's free, with no sign-up and no watermark.
How to Convert an MD File to PDF With QuickCatPDF
Converting Markdown takes four steps.
- Click Select Markdown files, drop files on the page, or choose Type or paste.
- Choose the Page size and Style, and whether you want a Table of contents.
- Click Download PDF, or Save as PDF on this device to print it from your browser without uploading.
- For several files, choose Separate PDFs or One combined PDF before you convert.
What Markdown Does It Support?
The converter reads GitHub-flavoured Markdown, the variant used by most code hosts, documentation sites and notes apps.
| Markdown | In the PDF |
|---|---|
| # Headings | Headings and PDF bookmarks |
| Lists and task lists | Numbered and bulleted lists, ticked and empty boxes |
| Tables | Bordered tables, with column alignment kept |
| Code blocks with a language | Highlighted code with wrapped long lines |
| Links | Working links; links to headings jump inside the PDF |
| Pictures | Pictures embedded in the file or in the uploaded folder |
| Front matter (--- at the top) | Left out of the document |
Raw HTML inside the Markdown is allowed for simple formatting, but scripts, forms and frames are removed. In our test, a guide with headings, a task list, a table, a Python code block and a line of Hindi converted in about 2 seconds; the PDF had a bookmark for each heading and the embedded script left no trace.
How Do You Keep the Pictures in a README?
Pictures stored next to a README are kept when you upload the whole folder as a ZIP. The tool finds the README (or the first Markdown file), and pictures with relative paths like img/logo.png are placed in the PDF.
Pictures linked from other websites aren't downloaded, so they appear as their alt text in brackets. Notes apps such as Obsidian and Notion export Markdown with a folder of attachments, which works the same way once zipped.
Which Style Should You Choose?
Clean uses a sans serif font with light code and table styling. Document uses a serif font with justified paragraphs, which suits reports and essays. GitHub looks like a README on a code-hosting site, with underlined top-level headings. A Table of contents adds a first page listing the headings, each one a link.
Frequently asked questions
Is Markdown to PDF free?
Yes, free with no sign-up and no watermark. Download PDF has a fair-use limit of 60 files an hour; Save as PDF on this device has no limit at all.
Does it support code blocks?
Yes, fenced code blocks are kept with their line breaks and highlighted for common languages such as Python, JavaScript, Java, C#, Go, SQL, Bash and JSON. Untick Highlight code for plain monospace.
Can I convert Markdown without uploading it?
Yes, click Save as PDF on this device. The document is built in your browser and saved through the print window, and it works offline once the page has loaded.
Will links work in the PDF?
Yes, web links stay clickable, and links to headings in the same file jump to that heading in the PDF.
Are page numbers added?
Yes, page numbers are added at the bottom of each page with Download PDF; untick Page numbers to leave them out. With Save as PDF on this device, your browser's print settings decide headers and footers.
Can I convert HTML or plain text too?
Yes, HTML files keep their own styling with HTML to PDF, and plain text converts with Text to PDF. Every other format is on Convert Any File to PDF.
Last updated: