Markdown Viewer for Mac. Double click, read, fix.
Markdown files open as clean, formatted pages. One switch shows the plain text underneath, with a toolbar for quick edits. A small Mac app we built for ourselves.
/ why we built it
The Mac has no Markdown viewer. So we built one.
More and more of our working documents are Markdown: specifications, plans, build notes and anything Claude writes. Astonishingly, the Mac has no built-in way to read them. A double click opens a text editor full of raw symbols. Everything we found online did far more than we needed, and came at a cost. So we built our own: one small app that opens the file as a clean, readable page, with quick edits when you need them.
/ at a glance
Small app. Does the job well.
Opens from Finder
Set it as the default app and a double click shows the page.
Preview and Source
Switch with one click, or Command and forward slash.
A formatting toolbar
Headings, bold, italic, lists, quotes, links, images, code, tables and dividers.
Full Markdown
Tables, task lists, nested lists, code blocks and local images.
Stays current
If Claude or another app changes the file, the page reloads and keeps your place.
Safe editing
Nothing is saved until you choose Save, and Undo works throughout.
Preview: the formatted page, in light mode.
Source: the Markdown text behind the same page.
/ get a copy
Want to try it? Ask and we will send it over.
Markdown Viewer runs on Apple Silicon and Intel Macs with macOS 13 or later. It is not yet signed with an Apple Developer ID, so for now we share it on request. Leave your details and we will send the app, with a short guide to installing it.
By sending this request, you agree that Nick Leeder & Co may store and use your details to reply to you. See our privacy policy.
/ questions people ask
Questions about Markdown Viewer
What is Markdown?
Plain text with a few simple symbols for headings, bold, lists and links, saved as .md files. It stays readable anywhere, and many tools, Claude included, write it.
Which Macs does it run on?
Apple Silicon and Intel Macs with macOS 13 or later.
Can it open every .md file by default?
Yes. The first time it opens, it asks to become the default app for Markdown files. You can also choose it in Finder: File, Get Info, Open with, then Change All.
Will it change my files?
Only when you choose Save. Undo works throughout, and the Preview never alters the file.
What happens if another app changes the file?
The page reloads and keeps your place, so you can keep a file open while Claude or another app works on it.
Does it work in dark mode?
Yes. It follows your Mac’s appearance, light or dark.
Why does the Mac ask before it opens the first time?
The app is not yet signed with an Apple Developer ID, so macOS checks it first. Right click Markdown Viewer in Applications, choose Open, then Open again. You only do this once.
Is there a user guide?
Yes. The Markdown Viewer user guide (PDF) covers installing the app, opening files, Preview and Source, and the toolbar.