There are a lot of ways to read markdown on a Mac. You can open it in a text editor and squint at the raw syntax. You can use VS Code and install three extensions. You can pay for something polished. Or you can find something in between that actually does the job without wasting your time.
We looked at the most popular options and broke down what each one is good at, where it struggles, and who it’s best for.
mdMD
mdMD is a native macOS app built with SwiftUI and AppKit. It opens markdown files with a split view (raw source on the left, styled preview on the right) and renders everything instantly.
Pros:
- Truly native. Launches in under a second, uses barely any memory.
- Split view lets you see raw markdown and rendered output at the same time.
- Slash commands, multi-tab support, and keyboard shortcuts that feel like a real Mac app.
- One-click rich HTML copy. Paste into Notion, Obsidian, Google Docs, and more.
- Completely free.
Cons:
- macOS 14+ only.
- No iOS or Windows version.
Best for: Anyone who wants to read and edit markdown without the weight of an IDE. If you just want to open a .md file or a note from your Obsidian vault and have it look good immediately, this is it.
MacDown
MacDown has been around for years and is one of the most well-known free markdown editors for macOS. It’s open source and uses a split-pane layout similar to mdMD.
Pros:
- Free and open source.
- Mature project with a large user base.
- Customizable CSS for the preview pane.
Cons:
- Development has slowed significantly. Updates are infrequent.
- Built on older frameworks. It can feel dated compared to modern macOS apps.
- No multi-tab support.
Best for: People who want a simple, proven editor and don’t mind the lack of recent updates.
Visual Studio Code
VS Code isn’t a markdown editor. It’s a full code editor that happens to handle markdown reasonably well. With the built-in preview pane and a few extensions, it can serve as a capable markdown viewer.
Pros:
- You probably already have it installed.
- Huge extension ecosystem. Markdown All in One, Markdownlint, and others add linting, shortcuts, and table of contents generation.
- Great for editing markdown inside a larger project.
Cons:
- It’s an Electron app. Heavy on resources for just reading a markdown file.
- Preview pane is functional but not pretty.
- You’re opening an IDE to read a text file, which is overkill if that’s all you need.
Best for: Developers who already live in VS Code and want to edit markdown alongside code without switching apps.
Typora
Typora takes a different approach. Instead of showing a split view, it renders markdown inline: your **bold** text turns bold as you type, and the syntax disappears. It’s a clean, focused writing experience.
Pros:
- Beautiful inline rendering. The closest thing to a WYSIWYG markdown editor.
- Supports themes, tables, math blocks, and diagrams.
- Cross-platform (macOS, Windows, Linux).
Cons:
- No longer free. It’s a one-time purchase after a trial period.
- Hides the raw markdown, which can be disorienting if you want to see the actual syntax.
Best for: Writers who want a distraction-free experience and prefer not to look at raw markdown at all.
Marked 2
Marked 2 is a dedicated markdown previewer. You don’t edit in it. You write in any editor you want, and Marked 2 watches the file and renders a live preview.
Pros:
- Works with any editor. Write in Vim, Sublime, or whatever you prefer.
- Advanced features like word count goals, readability stats, and custom preprocessors.
- Excellent rendering quality.
Cons:
- Paid app ($14).
- Preview-only. You still need a separate editor.
- Adds complexity to your workflow with the two-app setup.
Best for: Power users who have a favorite text editor and want a premium preview tool alongside it.
Quick Look extensions
macOS has built-in Quick Look, and there are extensions that add markdown rendering to it. Select a .md file in Finder, press Space, and see a rendered preview.
Pros:
- No app to open. Works right from Finder.
- Great for quickly scanning a README or doc.
Cons:
- View-only. No editing.
- Rendering quality depends on the extension.
- Not a real workflow. It’s a glance, not a tool.
Best for: Quickly previewing markdown files without opening anything. Good as a complement to a real editor, not a replacement.
The bottom line
If you’re a developer who already has VS Code open all day, just use that. If you want a beautiful writing experience and don’t mind paying, Typora is solid.
But if you want a fast, free, native macOS app that opens markdown files and makes them look great without any setup, download mdMD. It does one thing well, and it does it without eating your battery or your patience.