Skip to content

Markdown Preview

Pluk · A native Mac Markdown reader with document outlines, Finder Quick Look previews and integrated editing features.

CaskWriting & NotesAuto-updates 2.9K
Install command
brew install --cask markdown-preview
30-day installs
1,253
#231 in App
1-year installs
4.2K
Last 365 days
Latest version
0.0.74
Download size
10MB
dmg
Release cadence
Daily
6 releases in 30 days

About

Markdown Preview opens Markdown files as formatted documents on macOS. It combines a reading window with a heading outline and Finder Quick Look extension, helping users inspect notes, documentation and README files without starting a large development environment.

Features

  • Render Markdown headings, lists, tables and code in a document window.
  • Navigate sections through a document outline and search.
  • Preview Markdown files with Finder Quick Look and Spotlight.
  • Open files in a preferred external editor or use supported edit-mode tools.
  • Customize reading appearance and export supported document formats.

Setup and compatibility

The current official download requires macOS 15 or later. Drag the application into Applications and open a Markdown file. Enable or review its Quick Look extension in system settings if Finder previews do not appear. Feature behavior follows the installed release; an older promotional screenshot may show different system requirements.

Markdown Preview is free and open source under the MIT license, with optional contributions and no required account. Documents remain normal files. External application links can prompt for approval, and Quick Look remains read-only where documented. Review a document before printing or exporting, especially wide tables and custom HTML layouts.

Sources: Official website, Official release history.

At a glance

Price
Free
System
macOS 15 or later
Chip
Apple silicon · Intel
Auto-updates
Yes
Repository
Open source · MIT · Updated 1 day ago★2.9K
Developer
Pluk
Homebrew
Available; the app updates itself
Also known as
markdown-preview
Homepage
markdownpreview.app
Token
markdown-preview

Checked

What’s new in 0.0.74

New · From GitHub Releases

Edit the Markdown source

Markdown Preview 0.0.74 brings a Markdown source view in Edit Mode, files that keep their line breaks, and printing from Finder.

Added

  • Markdown Source in Edit Mode. Choose Show Markdown Source from the View menu, the formatting bar, or the context menu, or press ⇧⌘E, to edit the file exactly as written, with every marker visible, line numbers, and light syntax colors. Your selection, unsaved changes, and undo history carry over when you switch (#651).

Changed

  • Files Keep Their Line Breaks. A file with Windows or classic Mac line breaks saves with the same ones after an edit, so other tools show only the lines you changed (#651).
  • Faster Typing in Large Files. Edit Mode does less work on each keystroke in very large files, so typing stays responsive in a document of several megabytes (#651).
  • Language and macOS Version in Usage Analytics. The anonymous daily event now includes your Mac’s language and its full macOS version, such as 27.2, so translations and fixes go where readers need them. Settings → Privacy lists everything it sends (#655, #656).

Fixed

  • Print from Finder Works. Printing a Markdown file from Finder or a script opens the print panel instead of quitting the app (#653).

Contributors

How to install Markdown Preview on Mac

Homebrew installs the app in your Applications folder.

Install without Homebrew

Download the same file Homebrew uses: Install Details

Uninstall Markdown Preview and optional data cleanup

Uninstall command
brew uninstall --cask markdown-preview

A regular uninstall removes the app and keeps its settings and caches.

Deep clean (optional)
Uninstall command
brew uninstall --zap --cask markdown-preview

--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.

Questions about Markdown Preview

Is Markdown Preview safe?

Markdown Preview is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 1,253 times through Homebrew in the last 30 days.

Is Markdown Preview free?

Yes, Markdown Preview is free to use. Source: markdownpreview.app, checked Oct 18, 2026.

Is Markdown Preview open source?

Markdown Preview’s source code is public on GitHub (pluk-inc/markdown-preview) under the MIT license.

How do I completely uninstall Markdown Preview on a Mac?

Run brew uninstall --cask markdown-preview. It quits the app. To delete its settings and caches as well, run brew uninstall --zap --cask markdown-preview. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 10 files and folders, including ~/Library/Containers/doc.md-preview.

Does Markdown Preview run on Apple silicon (M1 and later) Macs?

Homebrew installs it on both Apple silicon and Intel Macs, from the same download. It needs macOS 15 or later.

Where does Markdown Preview store its settings and data?

Its settings are in ~/Library/Preferences/doc.md-preview.plist. Its data is in ~/Library/Containers/doc.md-preview, ~/Library/Containers/doc.md-preview.quick-look, and ~/Library/Group Containers/5P3TSMNV42.doc.md-preview. These locations come from Homebrew’s clean-up list.

What is the latest version of Markdown Preview?

The latest version is 0.0.74, added to Homebrew on Nov 17, 2026. Markdown Preview updates itself; to update it with Homebrew, run brew upgrade --cask --greedy markdown-preview.

What else does installing Markdown Preview add?

It also adds 1 command-line tool: mdp.

Similar Apps

  • GranolaAn AI meeting notepad that combines your written notes with computer audio to produce organized summaries and follow-up information.
  • JoplinAn open-source notes and to-do application with Markdown, attachments, notebooks, optional encrypted synchronization and extensible desktop workflows.
  • TyporaA Markdown editor with live formatting, a file sidebar, outlines, tables, code blocks and export workflows in a distraction-free writing view.
  • QuartoAn open-source technical publishing system for turning Markdown and computational notebooks into reports, websites, books and presentations.
Browse all apps