md2document
Platform

Markdown to PDF on macOS - without Homebrew, Pandoc or MacTeX

The classic Mac path for Markdown-to-PDF is Pandoc plus a TeX engine. That is a heavy install for documents the browser can render natively. Here is the no-install path, plus the editor pairings that fit it.

Elia Kuratli
By Elia Kuratli
·4 min read
Open the converter

The four-step macOS flow

  1. Open md2document.com in Safari, Chrome or Arc.
  2. Paste your Markdown into the editor.
  3. Pick a template and a design.
  4. Press ⌘E to export. The PDF lands in ~/Downloads.

The PDF preview renders on the right while you type. On a recent MacBook the round-trip from edit to redrawn preview is around 60ms, so what you read is what you get.

Pairings with the editor you already use

iA Writer, Bear, MacDown

These editors save plain Markdown to disk. ⌘A to select, ⌘C to copy, paste into the converter,⌘E to export. No round-trip through a server.

Obsidian

Obsidian's reading mode renders the file with plugin syntax (callouts, embeds, queries). The converter wants the raw Markdown - toggle source mode with ⌘E in Obsidian first, then select-all and copy. The dedicated Obsidian guide covers wikilink image syntax and the source-mode toggle in detail.

VS Code

Open the .md file, ⌘A / ⌘C, paste in the converter. No 200MB Chromium download required by the markdown-pdf extension. The VS Code guide covers the keyboard shortcut and task setup.

Typora

Typora has its own PDF export. The cases to reach for this converter instead: when you need a cover page, a real ToC, page numbers and a brand theme. The Typora guide compares both.

macOS-specific gotchas

  • Smart quotes.macOS' Substitutions feature can replace straight quotes with curly ones inside Markdown source. Turn it off for Markdown editors in System Settings > Keyboard > Text Replacements, or in the editor's preferences.
  • iCloud Drive paths. Files in iCloud Drive may evict locally. Drag the file out before opening so you do not hit a download stall while editing.
  • Print drivers. If you print the exported PDF on a US-target printer, the default page size (A4) will leave a small margin or get scaled. The Page section in the sidebar has an A4 / Letter toggle - switch to Letter before exporting if the destination is a US printer.

When Pandoc is still right

The Pandoc plus TeX path is the answer when the document needs LaTeX-grade math, a BibTeX-managed bibliography, or fits into a build pipeline (make pdf in CI). For everything else, this is the cheaper path. See the Pandoc-alternative comparison for the honest trade-offs.

Common questions

Do I need Homebrew or MacTeX?

No. The converter is a webpage. Safari, Chrome, Firefox, Arc and Brave all run it. The Pandoc-plus-MacTeX path is overkill for proposals, memos and resumes - keep it for math-heavy papers.

Why not Save as PDF from the macOS Print dialog?

Print-to-PDF captures the editor's screen rendering. That gives you the editor's font, the editor's syntax highlighting and the editor's margins - not a document. This converter renders to a print-grade layout with proper page chrome.

Does it run on Apple Silicon?

Yes. Every M-series Mac running a modern Safari handles the converter fine. Conversion is JavaScript; there is no native binary to worry about.

Will it work offline on my MacBook?

Once the page has loaded, yes. Fonts, parser and PDF engine cache in the browser. Useful on a plane or in a tunnel.

Related

← All guides