A lightweight native macOS Markdown viewer that runs from the terminal. Opens a window with a Finder-style toolbar and renders Markdown with GitHub-flavored styling.

mdv spec.md

• Native macOS window with unified translucent toolbar
• GitHub-flavored Markdown rendering (tables, code blocks, task lists, blockquotes)
• Automatic dark mode support
• Scrolling, text selection, window resizing
• Single binary (~88 KB), no dependencies at runtime

make            # compile
make install    # install to /usr/local/bin (or PREFIX=/path make install)
make clean      # remove build artifact

Requires Xcode Command Line Tools (xcode-select --install).

mdv README.md
mdv ~/docs/spec.md

The window closes the app on exit.

Swift, SwiftUI, AppKit, WebKit (WKWebView), marked.js for Markdown parsing.