The short answer
Use the VS Code preview while you are writing Markdown inside a project: editing a README, keeping docs beside code, checking that a table came out right. Use MarkdownPaper when you are reading Markdown, or handing it to someone who will: a long specification, a plan an AI assistant wrote, a document you want to print or paste into an email.
Where VS Code is the better choice
- You are editing. The preview sits beside the source, and the two scroll together in both directions as you type and read. MarkdownPaper has an editor and a split view, but they are there for fixing a document, not for living in.
- Diagrams and math need nothing extra. The built-in preview renders Mermaid diagrams, with pan and zoom, and math written with dollar signs through KaTeX. For those two, VS Code and MarkdownPaper now show the same things.
- The file lives in a repository. Search across the project, version control, and every other file are one click away in the editor.
- You want to extend it. Extensions add renderers, linters and export
commands, and the
markdown.stylessetting restyles the preview with your own stylesheet. - You already have it open. For a quick look at a README you are working on, switching to another app is not worth it.
Where MarkdownPaper is the better choice
- Long documents. Text is set at a comfortable reading width, around 74 characters a line, in a serif made for reading, with the contents in the margin so you can see where you are. Drag either edge of the page to change the width.
- Reading, not coding. There is no editor chrome, file tree or status bar around the page, and the few controls fade out while you read.
- People who do not use a code editor. A product manager, a client or a colleague can open the free web reader in a browser, with no install and no account.
- Printing and sharing. Print gives real page margins for a PDF, and a rendered document copies into Google Docs, Word or email with its headings, tables and code intact.
- Documents from AI assistants. Paste the Markdown a chat produced and read it as a page rather than as symbols, or keep the desktop app open on a plan that a coding agent is rewriting and watch the page follow the file.
Side by side
| VS Code preview | MarkdownPaper | |
|---|---|---|
| Built for | Writing, beside the source | Reading the finished page |
| Where it runs | Inside the VS Code editor | Any browser, or a Mac and Windows app |
| Install | VS Code | None for the web reader |
| Reading width | The width of the pane | Set in characters, adjustable |
| Contents | The Outline view in the sidebar | In the page margin |
| Math and diagrams | KaTeX and Mermaid, built in | KaTeX and Mermaid |
| Print and PDF | Through an extension | Built in, with page margins |
Price
VS Code is free, and so is its Markdown preview.
The MarkdownPaper desktop app: On the Mac App Store and the Microsoft Store. $6.99 launch price, paid once, with no subscription. About the desktop app.
The MarkdownPaper web reader is free as well, with no account and no limits.
Using both
The two do not compete for the same moment. Write and check in VS Code; when a document is ready to be read properly, or read by somebody else, open the file in MarkdownPaper or paste its text into the reader. Nothing is uploaded: the page is rendered in your browser.
If you write in a dedicated Markdown editor rather than a code editor, the Typora comparison covers that workflow, and the Marked comparison covers a previewer that sits beside any editor.
Questions
What is the shortcut for the Markdown preview in VS Code?
Cmd Shift V on a Mac, or Ctrl Shift V on Windows and Linux, opens the
preview in a tab. Cmd K then V, or Ctrl K then V, opens it beside the
source.
Does the VS Code Markdown preview render Mermaid diagrams?
Yes. According to VS Code's documentation, the built-in preview draws
mermaid fenced code blocks as diagrams, which you can pan and zoom. It also
renders math with KaTeX, which the markdown.math.enabled setting turns off.
Can VS Code open .md files in the preview by default?
Yes. Add this to your settings, and a Markdown file opens as its preview instead of its source:
"workbench.editorAssociations": {
"*.md": "vscode.markdown.preview.editor"
}
Can VS Code export Markdown to PDF?
Not by itself: its documentation describes no export command, and extensions from the Marketplace add one. Alternatively, open the file in MarkdownPaper and print it, which gives the page real margins. The Markdown to PDF page walks through it.