MacMD Viewer
Markdown reader for Mac
MacMD Viewer is a Markdown reader for your Mac, letting you read README files, technical documentation, and AI-generated docs without working through raw Markdown syntax.
by Arthur Teboul
What you get
Read Markdown as formatted documents without changing your editor.
With MacMD Viewer, you can read README files and Markdown documents from Claude or GPT as formatted pages rather than raw syntax. You get aligned tables, syntax-highlighted code, and rendered Mermaid diagrams, so you can follow the content without mentally decoding its markup.
You can also select a .md file in Finder and press Space to see a rendered Quick Look preview. When you’re writing, you can keep using your existing editor: save your changes, and the viewer updates automatically without a manual refresh. MacMD Viewer handles the reading and previewing, not the editing.
For longer documents, you can jump between sections using a table-of-contents sidebar that tracks your place as you scroll. You can choose from seven code-highlighting themes and set a light or dark appearance independently of your Mac’s system setting.
-
Read without decoding markup
You see formatted tables, highlighted code, and drawn Mermaid diagrams instead of their underlying Markdown.
-
Check files from Finder
You can press Space on a .md file to read a rendered preview through Quick Look.
-
Keep your existing editor
You see your saved changes appear automatically in the preview, without switching editors or refreshing manually.
-
Navigate long documents
You can jump to sections and track your reading position with the table-of-contents sidebar.
Best for
- You regularly read README files and technical documentation.
- You receive Markdown documents generated by Claude or GPT.
- You want an automatically updating preview alongside your preferred editor.
Skip it if
You don’t need it if your current editor or Markdown reader already gives you the previews and document navigation you want.
Screenshots
From the developer
MacMD Viewer is a markdown reader for Mac. Open a .md file and it renders exactly as intended — clean typography, syntax-highlighted code blocks, working tables, and Mermaid diagrams. It pairs with whatever editor you already use, watches the file, and reloads the moment you save.Read the full description
Alternatives to MacMD Viewer
Other apps to write & preview Markdown. See all