Markdown Viewer Mac: 7 Ways to Open .md Files on macOS

macOS ships no markdown viewer Mac users can double-click into. TextEdit opens a .md file as plain text and Quick Look shows the raw syntax. To read the file formatted you need one of seven routes. They range from a browser editor and a Quick Look plugin to native viewer apps, editors, a Terminal reader, and converters. This guide orders them from zero install to full app.

Does macOS Support Markdown Out of the Box?

No. Double-click a .md file on a fresh Mac and it opens in TextEdit, which shows ## Heading and **bold** exactly as typed. Select the file in Finder and press Space, and Quick Look shows the same unrendered text. If Xcode is installed, macOS may hand the file to Xcode instead, which is a code editor and also shows the source. Neither Apple app renders Markdown.

That surprises people because macOS has handled .rtf, .pdf, and .docx previews for years. Markdown is different: it's a plain-text convention rather than a document format, so a file only looks formatted after a renderer turns it into HTML. Every route below is a way of getting that renderer. The tools are the same whether you searched for a markdown viewer for Mac, a Mac markdown reader, or how to open an md file on Mac.

If you received a .md file and aren't sure what it is, What is Markdown? explains the format in a few minutes.

The 7 Ways to View a Markdown File on a Mac

Each route below states what you install, whether it hooks into Finder, and who it suits. Start at the top if you want the quickest result and work down if you want a permanent setup.

1. Open the File in a Browser-Based Markdown Viewer

The fastest way to open a Markdown file on Mac, and the only one that works on a machine you can't install software on, is a browser editor. Open the editor in Safari or Chrome, drag the .md file into it or paste the contents, and the right-hand pane renders it. Tables, task lists, fenced code with highlighting, and Mermaid diagrams all display, and you can export to PDF or HTML from the same page.

We prefer this route for reading a file someone sent us, because there's nothing to install and nothing to configure. The limitation is that it isn't wired into Finder: you open the browser first, then the file, rather than double-clicking. For an occasional file that's fine. For a folder of a hundred notes, one of the native options below is better.

Try the browser route now with the sample below.

2. Make Quick Look Render Markdown With QLMarkdown

Quick Look is the Space-bar preview in Finder, and a plugin teaches it Markdown. QLMarkdown by sbarex is free and open source (GPL), and version 1.5.3 shipped on 11 September 2026. Install it with Homebrew:

brew install --cask qlmarkdown

Then launch the QLMarkdown app once so macOS registers its Quick Look extension; the README is explicit that the extension isn't active until you do. After that, select any .md file in Finder and press Space to see it rendered, with support for .rmd, .qmd, and .mdx too.

This is the closest thing to native macOS markdown viewer behaviour, and it's the route we'd recommend to anyone who reads Markdown daily but writes it elsewhere. The plugin previews only; to edit, you still open the file in something else.

3. Install a Native Mac Markdown Viewer App

These are viewers, not editors: they open a .md file from Finder, render it, and reload when the file changes on disk.

• QuickMD is a native, Electron-free viewer released under the MIT license, with v1.10.0 published on 10 September 2026. It's free on the Mac App Store and on GitHub, renders GitHub-style alerts, LaTeX, and Mermaid, and reloads when you save from another editor.
• MarkViewer is a free offline viewer for GitHub-flavoured Markdown, available as a direct download or through Homebrew, with a WYSIWYG editing mode as well. Its site doesn't state a minimum macOS version, so check the download page.
• Marked 3 is the long-running paid previewer. It's a preview window that watches a file while you edit it in any other app, with custom styles and export options. Pricing on its site at the time of writing is $2.99 a month or a $69.99 one-time purchase for the Pro edition. It requires macOS 11 or newer.
• Markoff, thoughtbot's free CommonMark previewer, still appears in search results, but its repository (now at kaishin/markoff) was last updated in October 2020. Treat it as unmaintained.

If you only ever read Markdown, QuickMD is the one to try first: free, native, and it takes over double-click.

4. Use an Editor With a Preview Pane

Every Mac Markdown editor is also a viewer. VS Code opens .md files and shows a rendered pane with Cmd+K V; MarkEdit, MacDown, MarkText, Typora, iA Writer, and Obsidian all render as you type. The trade-off is weight and intent: you're launching an editor to read a file, and the split view shows source beside output whether you want it or not.

This post doesn't rank editors, because the best Markdown editors comparison and the Mac-specific markdown editor Mac roundup already do that with prices and release dates. The VS Code Markdown guide covers preview setup if VS Code is already on your machine.

5. Read Markdown in Terminal With glow

If you live in a terminal, Charm's glow renders Markdown with styling, pagination, and a file browser. It's open source, and v3.0.0 was released on 11 August 2026.

brew install glow
glow README.md

Headings, lists, code blocks, and tables render in the terminal, and glow with no arguments opens a file browser for the current directory. It won't show images, and wide tables wrap, but for READMEs inside a repository it's faster than switching apps. An alternative in the same style is pandoc README.md -o README.html && open README.html, which converts to HTML and opens the result in your default browser, though that needs Pandoc installed.

6. Convert the File and Open It in Preview or Safari

When the goal is reading rather than editing, convert once and use an app macOS already has. Our Markdown to PDF converter turns the file into a PDF that opens in Preview, prints correctly, and can be sent to someone who has no idea what Markdown is. The Markdown to HTML converter produces a page Safari opens directly. The Markdown to PDF guide compares this route with Pandoc and VS Code exports.

This is the right answer for one-off documents, contracts, and anything that has to look identical on every machine. It's the wrong answer for files that change daily, because you'll convert them again every time.

7. What Apple's Own Apps Can and Can't Do

TextEdit opens .md files but shows the source. Xcode does the same with syntax colouring. Safari has no Markdown renderer, so a .md file opened in it shows the source at best. Pages doesn't list .md among its import formats, and Preview only helps once the file is a PDF. So the honest answer to "does macOS support Markdown" is: it opens the file, it doesn't display it, and one of the six routes above fills the gap.

How Do You Change Which App Opens .md Files on Mac?

Once you've picked a viewer, make Finder use it. Right-click the file and choose Open With for a one-off, or set the default for every .md file:

1. Right-click the file and choose Get Info (or select it and press Cmd+I).
2. Expand the Open with section and pick your viewer from the menu.
3. Click Change All, then Continue to confirm.

From then on, double-click opens the file in your viewer, and Quick Look keeps working independently through QLMarkdown. If Xcode grabbed .md files when you installed it, this is how you take them back. Apple's Mac User Guide documents the same steps.

Markdown Viewer Mac FAQ

The right markdown viewer Mac setup depends on how often you read the format: a browser editor for the occasional file, QLMarkdown for Space-bar previews, QuickMD or Marked 3 as the double-click default, and a converter when the document has to leave the Markdown world. Whichever you pick, the editor is the zero-install fallback on any Mac.