Sashmark / Blog

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 -a from 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.

What Sashmark plans for v1: Features · Roadmap

View as Markdown