A tiny native macOS Markdown viewer/editor, with a Windows build. <1 MB on macOS — no Electron, no runtimes.
- Double-click any
.mdfile → rendered preview (registers as a Markdown editor with Finder) - Complete GFM rendering: tables, task lists, images, strikethrough, footnotes, syntax-highlighted code blocks
- Interactive preview: tick task-list checkboxes (written straight back to the file), one-click copy on every code block, links open in your browser
- Edit mode: ⇧⌘E toggles a plain-text editor, ⌘S saves (autosave/recents come from macOS)
- GitHub-style editing: a format bar and a Format menu — bold, italic, strikethrough, code, links, headings, quotes, bulleted/numbered/task lists, tables. Enter continues a list, Tab indents it, a pasted URL wraps the selection in a link, and a pasted or dropped image is saved into
./imagesnext to the document - Find & replace (edit mode): ⌘F find, ⌘⌥F replace — the native macOS find bar, regex included
- Quick Look extension: spacebar previews and Finder's preview pane render through the same pipeline
- GitHub-style light/dark theme, follows the system appearance
- Opens maximized; quits when the last window closes
Rendering is marked + highlight.js running locally (bundled, zero network at runtime) inside a WKWebView / JavaScriptCore. See THIRD_PARTY_LICENSES.md.
Requires macOS 13+ and the Xcode Command Line Tools (full Xcode not needed).
./build.shProduces build/MDView.app (ad-hoc codesigned).
./build.sh --sandboxSame app signed with the App Sandbox, as an App Store build must be. Local images then need a one-time folder grant (the preview offers a Show local images… button when one fails), which is why the sandbox is off by default.
- Copy
build/MDView.appto/Applicationsand launch it once. - Make it the default for Markdown: right-click any
.mdfile → Get Info → Open with → MDView → Change All. - Quick Look: if spacebar still shows plain text, enable MDView under System Settings → General → Login Items & Extensions → Quick Look.
Downloaded a prebuilt .app? It is ad-hoc signed, so Gatekeeper will block the first launch: right-click → Open → Open (or
xattr -d com.apple.quarantine MDView.app). Building from source avoids this.
windows/ is a Tauri shell (Rust + the system WebView2) around
the same renderer and the same editing code — windows/src-tauri/build.rs copies
Sources/mdview/Resources/ in at build time, so there is exactly one copy of
marked, highlight.js, the stylesheet and edits.js in the repository.
cd windows/src-tauri
cargo build --release # or: cargo tauri build (for an .msi/.exe installer)Roughly a 4 MB binary rather than Electron's ~150 MB. Before bundling installers,
generate the icon set once with cargo tauri icon ../../AppIcon-1024.png.
- Relative-path images render in the app, but not in Quick Look previews (needs QL attachments — noted in code).
- Under the sandbox, relative images need the folder granted once — the sandbox permits reading the opened
.mdfile only, not its siblings. - arm64 only as built; Intel needs a rebuild on x86_64.
- The Windows build has no find bar yet (macOS uses the native one) and no Quick Look equivalent.
MIT — see LICENSE. Bundled renderer libraries are MIT/BSD, see THIRD_PARTY_LICENSES.md.