Markdown Preview: A Lighter Way to Preview .md Files on macOS

Introduction

The Markdown problem I run into most often is small, but it shows up almost every day.

I only want to quickly read a README.md, a note, or a spec document. But macOS usually sends it to a plain text editor, or I end up opening VS Code. VS Code is fine, of course, but opening a full editor just to read one .md file sometimes feels too heavy.

Markdown Preview solves exactly that small problem: it lets .md files open and preview more like PDFs or images, without forcing every document into a code editor.

What Markdown Preview Does

Markdown Preview is a native macOS app for previewing Markdown files.

Its goal is simple: open an .md file and see the rendered Markdown directly. You do not need to enter an editor first, and you do not need to send the document to a browser extension or online service.

I think it is most useful for files like:

Project README.md files
Installation docs
Development notes
Markdown reports generated by AI
Blog drafts
Product specs or meeting notes

If you only want to read the content quickly and do not need to edit code right away, this kind of small utility is much lighter than opening a full IDE.

Download It From the Official Site First

Before installing, download Markdown Preview from the official site:

Markdown Preview official website

I would point readers there first, instead of having them search around for random installers. The site currently presents it as Markdown Preview for macOS. After downloading it, you can open it like a normal macOS app.

Step One: Make Markdown Preview the Default App for .md Files

The first setup flow in the official README is making Markdown Preview the default app for .md files.

The steps are straightforward:

Find any .md file in Finder
Press Command + I to open the Info panel
Find Open with
Choose Markdown Preview
Click Change All

After that, double-clicking Markdown files will open them directly in Markdown Preview.

I think this step matters. If you do not set it as the default app, it is just another tool you occasionally open manually. Once it becomes the default, the Markdown file experience across macOS starts to feel smoother.

Quick Look: Read Markdown Before Opening the App

The most important update in 1.0.5 is the rebuilt Quick Look preview.

Usually, selecting a Markdown file in Finder and pressing the spacebar gives you a fairly plain .md preview. In this version, Markdown Preview uses a native Markdown renderer for Quick Look and supports more Markdown file types.

That means you can press the spacebar in Finder and quickly inspect a document before opening the app.

For me, this is more useful than it first sounds. A lot of the time I am not trying to edit a Markdown file. I just want to confirm whether this is the document I was looking for.

Search: Better for Long READMEs and Spec Docs

Markdown Preview also improves search.

The README notes that 1.0.5 fixed the toolbar search button so Find opens more reliably. In-app search also now includes:

Match counts
Next / previous navigation
Active-result highlighting
Command + F shortcut

This is useful for long documents.

Many project READMEs have install, usage, config, troubleshooting, and API reference sections. Once a file gets long, scrolling around manually gets annoying. Being able to hit Command + F and search for a keyword makes it feel more like a proper document reader.

Appearance and Font Size: The Controls a Reading Tool Actually Needs

Starting from 1.0.4, Markdown Preview moved its controls into a cleaner toolbar.

The top bar now focuses on controls you actually use while reading:

Sidebar toggle
Appearance control
Font-size controls
Search

Font size can be switched between small, medium, and large.

For Markdown reading, font control matters more than I expected. Some READMEs are dense, and small text gets tiring. Other documents are only for quick scanning, where a larger font is unnecessary. A simple text-size switch is more useful than a huge settings panel.

Preview / Edit / Split: Not Just Reading, but Quick Edits Too

Another useful part of 1.0.5 is that Markdown Preview can edit Markdown directly inside the app.

It supports three modes:

Preview
Edit
Split

Preview is for pure reading.

Edit is good for quick one-line changes.

Split lets you write on one side and see the rendered preview on the other.

I would not treat it as a full Markdown IDE, but it is convenient for fixing a typo in a README, changing a heading, or adding a short note without switching back to VS Code.

Who It Fits

I think Markdown Preview fits these users best:

People who often browse Markdown files in Finder
People who do not want to open VS Code just to read a README
People who write blog posts or docs and want to quickly check formatting
People who receive AI-generated Markdown reports
People who like handling everyday files with native macOS tools

It is not trying to replace Obsidian, VS Code, Typora, or a full writing and knowledge-management setup.

It is more like a small, focused utility: it fills the Markdown preview gap inside macOS.

Things to Watch

The README says Markdown Preview requires macOS 15.0 Sequoia.

So if your Mac is still on an older system version, check that before installing.

Also, its positioning is very clear: it is a native Markdown preview tool. If you need plugins, backlinks, databases, or complex note management, this is not that category of product.

But if your need is simply “I want to preview Markdown quickly without opening an editor every time,” it lands in the right spot.

My Own Use Case

My most common use case is reading READMEs for tool projects.

When I am preparing blog posts or testing AI tools, I often download a lot of repos, demos, and docs. Almost every one of those folders contains Markdown files.

Before this, I would usually throw the whole thing into VS Code. But that often turns “I just want to read a file” into “I opened the entire project.” Markdown Preview works more like a reading layer, letting me quickly decide whether the content is what I need.

If I really need to edit code, I still go into VS Code. If I only need to read the docs, I stay in Markdown Preview.

That separation is small, but it gets smoother over time.

Notes

Markdown Preview is one of those macOS tools that looks small, but can show up in daily use.

It is not trying to make the Markdown workflow huge. It focuses on doing a basic thing well: making .md files easy to preview, search, read, and lightly edit on macOS.

If you often open README files in Finder, read Markdown reports generated by AI, or just feel annoyed that every .md file sends you into VS Code, this is worth trying.

Once the video is added, this article will use demo.mp4 to show the full flow.