Native macOS App

Markdown, rendered
beautifully.

A focused reader for your documents. GPU-accelerated, distraction-free, and built for the Mac.

Download for Mac Explore features
macOS 13 Ventura or later
README.md
Files
README.md
CHANGELOG.md
CONTRIBUTING.md
docs/
setup.md
api.md
# Getting Started

This document walks you through installation, configuration, and basic usage. All settings persist between sessions and live in ~/.config/markdownish/config.toml.

## Installation
# build the release binary cargo build --release # run with an optional file ./target/release/markdown-viewer [file.md]
## Keyboard Shortcuts
  • Ctrl+T — open new pane
  • Ctrl+W — close active pane
  • Ctrl+B — toggle file browser
  • Ctrl+O — open file dialog

What's inside

Everything you need. Nothing you don't.

A focused set of features built around reading. No subscriptions, no cloud, no accounts.

Multi-Pane Split View
Open multiple documents side-by-side. Compare changelogs, reference docs while writing, or keep a table of contents always visible. Panes are equal-width and fully independent — click a tab to switch, drag a file to open in any pane.
File Browser
A sidebar tree of your directories. Toggle with Ctrl+B. Ctrl+click any file to open in a new pane.
Anchor Navigation
Links like #section-name scroll the document smoothly. Every heading gets an auto-generated slug.
Themes
Ships with Catppuccin Mocha (dark) by default. Configurable background, text, heading, link, and code colors — all saved to disk.
Full Markdown Support
Headings, fenced code blocks, tables, lists, blockquotes, inline code, bold, italic, strikethrough, links, and images — all rendered correctly.
GPU-Accelerated Rendering
The SwiftUI frontend renders via Metal — text layout happens on the CPU via Core Text, then the viewport is uploaded as a texture and drawn in a single GPU pass.
Typography Controls
Adjust font size and content width in the settings panel. Changes apply instantly — no restart required.
Persistent Settings
All preferences — theme colors, font size, content width, last opened files — are saved to ~/.config/markdownish/config.toml and restored on next launch. No database, no hidden state.
Requirements
PlatformmacOS 13 Ventura+
ArchitectureApple Silicon + Intel
Size~3 MB
FrameworkSwiftUI + Metal
NetworkNone required
Technology
ParserRust + pulldown-cmark
RenderingCore Text + Metal GPU
Config formatTOML
Native libraryUniversal fat binary
LicenseMIT

Ready to read better.

Free, open-source, and always will be.

Download for macOS

macOS 13+  ·  Apple Silicon & Intel  ·  Free