The Markdown reader macOS never shipped.
Double-click to read, spacebar to preview — nothing more.
- Read-only — No edits, no auto-formatting. Your files stay untouched.
- Quick Look — Spacebar on any .md in Finder. Rendered, not raw.
- Lightweight — Native Swift. Opens in under a second, stays out of your way.
- Syntax highlighting — 19 languages auto-detected, or specify the language on your code fence.
- Math rendering — Inline (
$x^2$) and display ($$\int f\,dx$$) TeX equations via KaTeX, fully offline. - Mermaid diagrams — Flowcharts, sequence diagrams, pie charts, and more.
- Dark mode — Follows your system appearance automatically.
- Default reader — One click to replace Xcode or TextEdit as your .md handler.
On first launch, Readdown walks you through this — but here are the manual steps:
- Open System Settings > General > Login Items & Extensions
- Click i next to Quick Look
- Toggle Readdown on
Get the latest release from GitHub Releases.
Requires macOS 13 Ventura or later.
- Clone the repo
- Open
ReadDown.xcodeprojin Xcode - Build and run (requires macOS 13+)
Found a bug or have a feature request? Open an issue.
Source-available. You may view, study, and contribute, but redistribution is not permitted. See LICENSE for details.
If you find Readdown useful, you can buy me a coffee.
Each Readdown release can be sponsored, with a credit on the website, in the GitHub release notes, and here. To become a release sponsor, reach out at hello@readdown.app.
