MarkdownPaper: Markdown Viewer

MarkdownPaper is a Markdown viewer and reader for Mac. Double click any .md file, or select it in Finder and press Space, and read it as a clean, typeset page, like a finished document rather than code.

Markdown is everywhere now. READMEs, meeting notes, project plans, and the plans and reports your AI tools write all arrive as .md files. Most apps show them as raw text full of symbols, or squeeze a Markdown preview into a small pane beside the code. MarkdownPaper is a Markdown file viewer that gives the finished document the whole window. It is a README viewer for every repository on your Mac, and a calm place to read the plans, specs and reports AI coding agents leave behind.

RIGHT IN FINDER

• Quick Look Markdown preview: select any .md file and press Space to see it typeset, without opening an app. • Double click to open. MarkdownPaper offers to become your default app for Markdown, so every .md file opens as a page. • Live updates: when another app or an AI coding tool changes the file, the page follows. Rename or move the file and your library keeps up. • From Terminal too: the free mdpaper command opens a file in MarkdownPaper, handy right after an AI coding agent writes a plan.

A PAGE WORTH READING

• A comfortable line length, real typography and a calm layout. • Everything renders: tables, task lists, footnotes, callouts, math and Mermaid diagrams. • Code blocks with highlighting, file names and marked lines. Copying a terminal session takes only the commands. • Images stored beside a README appear on the page. • Expand any image or diagram to fill the window. • Three paper styles: white, warm paper and a true dark mode. • Set the page width by dragging its edges, and choose your text size.

FIND YOUR WAY

• Find with Command-F: every match is marked on the page and listed by section. • A contents list in the margin of long documents. Point at the left edge to jump to any section. • Open a whole folder of notes or docs at once.

EDIT WHEN YOU NEED TO

• A focused Markdown editor, or the source beside a live preview. Changes save back to your file. • Tick a task box on the page and the file updates. • The controls stay out of the way and fade while you read.

SHARE AND EXPORT

• Save as PDF: print with proper page margins, or save a PDF from the print dialog. • Save as HTML: one self contained file with its styles and fonts inside, that opens anywhere, even offline. • Copy as formatted text: paste into documents, email or chat with headings, lists and tables intact. • Copy a share link: for shorter documents, the whole document travels inside the link, not through a server, and opens in any web browser.

Discovery signals