Guide
Convert Markdown to PDF on Mac and Windows
You wrote your notes, your README, or your report in Markdown. Now someone needs a PDF. The good news: you don't need the same tool on every machine, and you don't need to install anything at all if you don't want to. This guide covers the fastest routes on both macOS and Windows, from a zero-install browser converter to Pandoc for people who script.
The cross-platform method: convert in your browser
The one method that works identically on macOS and Windows — and on Linux, ChromeOS, or anything else — is a browser-based converter. Open ConvertMDapp in any browser (Chrome, Safari, Edge, or Firefox), paste or type your Markdown, watch the live preview, and export a clean PDF.
A few things make this the path of least resistance:
- Nothing to install. No Homebrew, no LaTeX, no admin rights. It runs in the tab you already have open.
- Private by design. The conversion happens 100% in your browser. Your files never leave your device — nothing is uploaded to a server, which matters for work documents, contracts, or anything confidential.
- Same experience everywhere. The Mac at home and the Windows laptop at work behave exactly the same. No "it works on my machine" surprises.
- No signup, no watermark. It's free, there's no account wall, and the PDF comes out clean.
You also get a light/dark theme and can download the raw .md back out if you edited it in the preview. For most people, most of the time, this is the whole answer. Open the converter and try it with a file you have right now.
On macOS
Mac users have several good options depending on how you like to work.
The browser converter
Everything above applies. Open ConvertMDapp in Safari or Chrome and export. This is the quickest option and needs zero setup — start here unless you have a specific reason not to.
Desktop editors: Typora and Marked 2
If you live in a dedicated Markdown editor, use its built-in export. Typora (File → Export → PDF) renders and exports in one step and is popular for long-form writing. Marked 2 is a Mac-native preview app that watches a file in your editor and exports styled PDFs with custom CSS. Both are paid apps, so they make sense if you're already using them daily.
Print to PDF from a rendered preview
macOS has a system-wide PDF export built into the print dialog. Open your rendered Markdown in any app that shows it as formatted text — a browser preview, an editor's preview pane, or a Marked window — then press Cmd+P and choose PDF → Save as PDF in the lower-left of the print sheet. The catch: you need the rendered output on screen, not the raw .md source, or you'll get a PDF of asterisks and hash marks.
Pandoc for CLI users
If you're comfortable in Terminal and want repeatable, scriptable conversions, install Pandoc with Homebrew:
brew install pandoc
# then convert a file:
pandoc notes.md -o notes.pdf
For nicely typeset PDFs, Pandoc uses a LaTeX engine under the hood. If you don't already have one, add a lightweight TeX distribution:
brew install --cask basictex
Pandoc shines when you need to convert many files, apply templates, or wire conversion into a build script or Git hook.
On Windows
The options mirror macOS, with Windows-native equivalents for the command line and printing.
The browser converter
Same as everywhere: open ConvertMDapp in Edge, Chrome, or Firefox, paste your Markdown, and export the PDF. No install, nothing uploaded, identical to the Mac version. If you switch between a Windows desktop and a Mac laptop, this keeps your workflow consistent.
Typora
Typora runs on Windows too, with the same File → Export → PDF flow. If you already write in it, that's your fastest local route.
Print → Microsoft Print to PDF
Windows ships with a virtual PDF printer. Open your Markdown rendered in Edge — for example, a preview page or the browser converter's output — press Ctrl+P, and pick Microsoft Print to PDF as the printer. As on macOS, this prints what's on screen, so make sure you're looking at the formatted page, not the raw source text.
Pandoc for CLI users
Install Pandoc with either Chocolatey or winget, whichever package manager you use:
choco install pandoc
# or, with winget:
winget install --id JohnMacFarlane.Pandoc
# then convert:
pandoc notes.md -o notes.pdf
As on macOS, PDF output needs a LaTeX engine. MiKTeX is the common choice on Windows:
choco install miktex
Once set up, the pandoc notes.md -o notes.pdf command is identical across both operating systems — handy for shared scripts.
Comparison of methods
| Method | macOS | Windows | Installs anything | Best for |
|---|---|---|---|---|
| Browser converter (ConvertMDapp) | Yes | Yes | No | Everyone; quick, private, zero-setup conversions |
| Typora / Marked 2 | Yes | Typora only | Yes (paid) | People already writing in a dedicated editor |
| Print to PDF from preview | Cmd+P → Save as PDF | Ctrl+P → Microsoft Print to PDF | No | One-off exports of an already-rendered page |
| Pandoc (CLI) | brew install pandoc |
choco/winget install |
Yes | Automation, batch jobs, custom templates |
Which should you pick?
For the vast majority of people, use the browser converter. It's free, requires no installation, keeps your files on your device, and works the same on a Mac or a PC — there's no reason to configure anything heavier for a quick conversion. Convert your Markdown to PDF now.
Reach for Pandoc only when you need automation: converting dozens of files, applying a house style with templates, or running conversions inside a build pipeline. It costs more to set up but pays off when the work is repetitive.
Want to go deeper on the mechanics and styling options? See the full pillar guide on how to convert Markdown to PDF. If your notes live in Obsidian, there's a dedicated walkthrough for exporting Obsidian to PDF.
FAQ
Can I convert Markdown to PDF without installing anything? Yes. A browser-based converter like ConvertMDapp runs entirely in the tab — open it in Chrome, Safari, Edge, or Firefox, paste your Markdown, and export. Nothing to download on either macOS or Windows.
Is it safe to convert confidential documents online? With ConvertMDapp the conversion happens 100% in your browser, so your files never get uploaded to a server. That on-device processing makes it suitable for private or work documents.
Do the Pandoc commands differ between Mac and Windows?
Only the install step differs — brew install pandoc on macOS versus choco install pandoc or winget install --id JohnMacFarlane.Pandoc on Windows. The actual conversion command, pandoc notes.md -o notes.pdf, is identical on both.