Markdown viewer for Mac: how to pick one
Bobby Huang ·
On a Mac you can read Markdown as plain text in TextEdit, formatted in a code editor's preview, in Terminal with less, in a browser page, or in a reader app. Pick one that shows tables, check boxes and code cleanly, reloads when the file changes, and follows your Light or Dark appearance. Then make it the default for .md files with Get Info and Change All, and open files in it from Terminal with open -a.
Key takeaways
- TextEdit opens a .md file as plain text, marks and all. To see it formatted you need a viewer.
- A good Mac viewer shows tables, check boxes and code cleanly, reloads when the file changes, and follows your Light or Dark appearance.
- Get Info and Change All make one viewer the app a double-click opens for every .md file.
- In Terminal, open notes.md uses that default app, and open -a picks a named app just once.
- Sashmark is a Markdown reader and editor for people whose AI agents write Markdown. It is in development and has not been released.
You are on a Mac, and you want .md files to open formatted, not as a page of # and ** marks. This guide covers the kinds of Markdown viewer you can use on a Mac, what to check before you pick one, and how to make it the app that opens your files. If you only need to read one file right now, start with opening and reading a Markdown file on Mac, Windows and Linux.
Kinds of Markdown viewer on a Mac
TextEdit, as plain text
TextEdit comes with macOS and opens a .md file as plain text. You see the file exactly as it was written, marks and all. That is fine for a quick look or a small fix, but tables and long lists are hard to follow. From Terminal, open -e notes.md opens a file in TextEdit.
A code editor's preview
Many code editors can show a formatted preview next to the source. This is a separate install, not part of macOS. It suits you if the editor is already open all day. The file is open for editing, though, so a stray keystroke can change it.
Terminal
less notes.md pages through a file and lets you search with /. cat prints a short file in one go. Both show plain text. The terminal guide also covers pandoc, a separate install that gives a formatted read.
A browser page
The free Markdown viewer on this site shows a pasted or opened .md file formatted. It runs in your browser, and nothing is uploaded. To see a newer version of the file, open it again.
A reader app
Some desktop apps are built for reading Markdown rather than writing it. Hold them to the checks below before you make one your default.
What to check in a Mac viewer
- Formatting. Tables, check boxes, fenced code and local images all show formatted.
- Reloads. When an agent or another app rewrites the file, the page updates and keeps your place.
- Light and Dark. The page follows the Appearance setting in System Settings. The dark mode guide shows how to check what your Mac is set to.
- Finder and Terminal. A double-click opens the file, and so does
open -afrom Terminal. - The file left alone. Reading never writes to the file.
The guide on what to look for in a Markdown reader for agent files explains each check and has a two-minute test you can run on any viewer.
Make your viewer the default for .md files
Select a .md file in the Finder, choose File > Get Info, pick your viewer under "Open with" and click Change All. From then on, a double-click opens every .md file in that viewer. The step-by-step version has each click.
Open a file from Terminal
The open command works with any app:
open notes.md # the default app for .md files
open -a "App Name" notes.md # a named app, this time only
open -e notes.md # TextEdit
Replace App Name with the viewer's name as it appears in the Applications folder. open -a does not change your default.
Test it with one file
Before you commit to a viewer, save the sample file from the two-minute reader test, open it with open -a, add a line with printf from Terminal, and compare shasum -a 256 results before and after you close it. If the page updated, kept your place and the checksums match, the viewer passes.
Where Sashmark fits
Sashmark is a Markdown reader and editor for people whose AI agents write Markdown. It is in development and has not been released, and there are no AI features in the app. It is planned for macOS, Windows and Linux, and its v1 plan covers the checks above: Live Reload that keeps your Reading Position, light and dark themes that follow the system, opening files from the terminal, and saves designed to change only the lines you edited. Read more at sashmark.com.
Questions
- Does macOS come with a Markdown viewer?
- macOS comes with TextEdit, which opens a .md file as plain text, so you see the raw marks such as # and **. To read it formatted, use a code editor's preview, a browser page or a reader app.
- How do I open a Markdown file in a specific app from Terminal?
- Run open -a with the app's name and the file, for example open -a "App Name" notes.md. Plain open notes.md uses the default app for .md files, and open -e notes.md uses TextEdit.
- Why does my Markdown viewer stay light when my Mac is in Dark mode?
- The viewer does not follow the system appearance, or it has its own theme setting that overrides it. Check the viewer's settings first, then check the Appearance setting in System Settings.