mkdn

the reading side of the agentic loop. code, diagrams, and math, rendered natively and updated live.

Install View on GitHub

not a code editor. a code viewer built for comprehension.

pure SwiftUI. launches instantly, idles at nothing, feels like it belongs on your Mac.

File watching at the kernel level. When an agent writes a file, mkdn re-renders it instantly. No reload button.

what agents produce, rendered natively

flowcharts, sequence diagrams, state machines, all inline and interactive.

Tree-sitter highlighting across 16 languages. Code blocks with language labels, themed backgrounds, and click-to-copy.

block and inline equations. renders like a textbook, not a code block.

full CommonMark: tables, lists, blockquotes. everything agents use to organize output.

dark and light modes that match your terminal. built for long sessions.

point it at a folder. sidebar, file watching, the whole tree at a glance.

macOS 14.0 or later.

Homebrew

brew install jud/mkdn/mkdn

Build from source

git clone https://github.com/jud/mkdn.git && cd mkdn && swift run mkdn