MarkdownViewer

Read markdown,
not markup.

A native macOS viewer for Markdown files with live reload, Mermaid diagrams, and a CLI that stays out of your way.

Install with Homebrew

brew tap tvaisanen/tap brew install --cask mdview

GitHub Flavored Markdown

Tables, strikethrough, autolinks, and task lists. Renders what GitHub renders.

Mermaid Diagrams

Flowcharts, sequence diagrams, and more. Rendered inline alongside your markdown.

Live Reload

Edit in your editor, see changes instantly. File watching with scroll position preserved.

Terminal CLI

mdview README.md opens the file and returns your terminal immediately.

Sidebar & TOC

File panel and table of contents. Auto-shows on hover, pins on click.

Brightness Control

Dim the content to save your eyes. Slider in the status bar, persists across launches.

Usage

# Launch the app mdview # Open a file mdview README.md # Open multiple files mdview design.md spec.md notes.md