Markdown that reads
like paper

A macOS viewer and editor for the documents you keep. Warm cream stock, a serif at a fixed reading measure, and GitHub-flavored rendering done entirely offline. No network, no telemetry, no account.

Install See it

Requires macOS 14

Built for reading, not for demoing

Every part of it answers a question a markdown reader actually runs into.

Eight palettes, one list

Every colour in the app is a token, and the token's name is the CSS custom property the preview page reads - so the window chrome and the document are never two palettes pretending to be one. Body text is held to 7:1 contrast against its own background by the test suite, which is why the ported schemes are lifted rather than copied.

Keyboard

The pane toggles are Option-Command, because a menu shortcut is matched before the responder chain and plain Cmd-V would have taken Paste out of the editor.

Install in one command

Downloads the latest build and installs it to /Applications.

$ curl -fsSL https://raw.githubusercontent.com/dux/md-boss/main/install.sh | bash

On first launch the app writes a md-boss command into ~/bin, so md-boss . opens the current folder in the sidebar.

Or build it yourself

SwiftPM and a hammer file, no Xcode project. Needs macOS 14, a Swift 6.2 toolchain and swiftlint.

$ git clone https://github.com/dux/md-boss && cd md-boss
$ hammer dev # lint, test, build, install, launch
$ hammer watch # rebuild on every Swift file change