Skip to content
TabShedKitsMy desk

Turn Markdown Notes Into a Clean PDF: Styles, Tables and Limits

Updated 5 min readBy

Convert README files, meeting notes or a thesis chapter in Markdown to a PDF. Pick Clean, Serif or GitHub style and know what is not supported.

Markdown to PDFMarkdown to a clean PDF, tables and code included
Open Markdown to PDF
On this page
  1. Start with the preview, not the download
  2. Choose a style that suits the reader
  3. What Markdown features are supported
  4. Mistakes that look like tool bugs
  5. Code blocks
  6. Several files at once
  7. Fonts and languages
  8. Privacy and drafts
  9. Worked example: meeting notes to a handout
  10. Worked example: a long guide
  11. Large files
  12. Better choices in some situations
  13. FAQ

You write in Markdown because it is fast and portable. Then comes the moment when someone needs a document: a client who does not know what a pound sign means, a printout for a meeting, an attachment for an application. Copying the text into a word processor and restyling it by hand is the slow way. The Markdown to PDF tool takes the Markdown itself and produces a PDF in your browser, with a live preview as you type.

Start with the preview, not the download

Paste or type your Markdown, or drop one or more .md files. The preview updates as you type and shows what will go into the PDF. Look at it before you look at any option: most problems with a Markdown conversion are problems in the Markdown, such as a missing blank line before a list or a table row without its separator line, and they are visible in the preview at once.

Choose a style that suits the reader

StyleFeels likePick it for
CleanNeutral sans-serif documentBusiness notes, handouts, README files for non-developers
SerifBook or paperEssays, thesis chapters, anything read at length or printed
GitHubThe look of a repository pageTechnical docs where readers expect that familiar style

The rest of the page is set with A4 or Letter, the margins, the text size, page numbers and an optional table of contents. For a long document, turn on the table of contents and page numbers together: a contents list with no page numbers on the pages is of little use.

What Markdown features are supported

The tool understands GitHub-flavoured Markdown: headings, bold and italic, links, images, ordered and nested lists, task lists, tables with alignment, block quotes, horizontal rules and fenced code blocks, with syntax colours for common languages. Raw HTML inside the Markdown is cleaned and used too, which lets you add a line break or a small piece of formatting that Markdown itself cannot express.

Two things are not supported yet. Mermaid diagrams and mathematical formulas appear as plain code blocks. If a diagram matters, export it as an image from the tool that draws it and reference the image in your Markdown.

Mistakes that look like tool bugs

  • A list shows as one paragraph. Markdown needs a blank line before the first list item. Add one.
  • A table appears as raw pipes. The header needs a separator row of dashes under it, such as | --- | --- |. Without it the table is plain text.
  • Numbered items restart. Interleaving paragraphs between list items can break a list. Indent the in-between paragraph by four spaces to keep it in the list.
  • A line break is ignored. Standard Markdown joins lines in one paragraph. End the line with two spaces or leave a blank line.

Code blocks

Fenced code blocks with a language name, for example three backticks followed by python, receive syntax colours for common languages. Without a language name the block is shown in plain monospaced text. Keep very long lines short in the source if exact indentation matters, because a PDF page is narrower than a code editor.

Several files at once

Drop several .md files and you get one PDF per file in a ZIP, or switch on the combined option to join them into one PDF in order. This is a convenient way to turn a documentation folder into a single reference. Name files so that alphabetical order is reading order, such as 01-intro.md, 02-setup.md, and check the order shown before you download.

Fonts and languages

The PDF is a text PDF with embedded fonts, not a screenshot, so you can select, copy and search it. Vietnamese, Cyrillic and Greek text work. Characters that no built-in font has, such as Chinese and emoji, are drawn as small pictures: they look right, but you cannot search for them. If your notes are in Chinese, Japanese or Korean, check a printed page for size and clarity before sharing.

Privacy and drafts

The PDF is made in your browser, and your Markdown never leaves your device. A draft is kept only in this browser, so if you close the tab and come back the text is still there. That also means clearing your browser data removes it, so save the .md file you care about elsewhere.

Worked example: meeting notes to a handout

  1. Paste the notes. Put the date and attendees under a top-level heading, decisions under a second-level heading and actions as a task list.
  2. Choose Clean, A4, normal margins, text size medium. No table of contents; the document is two pages.
  3. Turn on page numbers so the printed copy is easy to refer to.
  4. Download the PDF, then sign or add handwritten approval in the PDF editor if needed.

Worked example: a long guide

  1. Combine chapters into one document or use the combined-files option.
  2. Choose Serif for readability, switch on the table of contents and page numbers.
  3. Skim the preview for headings that are too long: a heading that wraps over three lines looks poor in the contents list.

Large files

There is no page limit and no watermark. Very large files are generated when you press Download instead of while you type, so the preview of a book-length document may be less immediate than for a short note.

Better choices in some situations

If you need the reader to edit the result, export to Word with Markdown to Word instead; a PDF is for reading and sharing, not editing. If you start from a PDF and want Markdown, PDF to Markdown goes the other way. For a document with rich layout, use the online document editor.

FAQ

Does it support Mermaid or math?

Not yet; they are shown as code blocks.

Can I add page numbers to a PDF I already have?

Yes, with Add Page Numbers to PDF.

Is the text searchable?

Yes, apart from characters drawn as pictures.