mdiew

A fast, native macOS markdown viewer built with Rust.

Renders markdown files using a WKWebView with GitHub-flavored styling, Mermaid diagram support, syntax highlighting, and live file watching.

Features

• GitHub-flavored markdown (tables, task lists, footnotes, strikethrough, autolinks)
• Mermaid diagram rendering
• Syntax highlighting via syntect
• Live reload on file changes with scroll position preservation
• Find in page (Cmd+F)
• Export to HTML/PDF
• Open as .app bundle with Finder integration

Installation

Homebrew

brew tap SeungheonOh/mdiew https://github.com/SeungheonOh/mdiew
brew install --cask mdiew

Install script (from GitHub Releases)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/SeungheonOh/mdiew/releases/latest/download/mdiew-installer.sh | sh

Build from source

Requires Rust and macOS.

git clone https://github.com/SeungheonOh/mdiew.git
cd mdiew
cargo build --release

The binary will be at target/release/mdiew.

Install as .app bundle

make install

This builds the release binary, creates mdiew.app in /Applications, and registers it with Launch Services.

To also set mdiew as the default viewer for .md files:

make default

Requires duti (brew install duti).

Usage

mdiew README.md

Or open any .md file from Finder after installing the .app bundle.

Keyboard shortcuts

Uninstall

make uninstall