v1.2.0
- Theme import/export with conflict resolution (overwrite/keep both/skip) - Theme schema versioning: schemaVersion field, migrateIfNeeded on load with write-back - Unit tests for theme decoding, migration, and round-trip (markdownViewrTests target) - Max content width setting in General tab (checkbox + slider, default 1000px enabled) - Homebrew cask: brew install --cask darinkelkhoff/tap/markdownviewr - Copy button replaces Duplicate in Themes settings - Settings min-width bumped to 560px - Help updated for new features; CLAUDE.md documents migration process Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
markdownViewr
A fast, beautiful markdown viewer for macOS. Open any markdown file — it live-reloads as you edit in your favorite editor.
Download
Download for Mac — macOS 13 Ventura or later, free.
Open the DMG, drag markdownViewr to Applications, and you're done.
Or install via Homebrew:
brew install --cask darinkelkhoff/tap/markdownviewr
Features
- GitHub Flavored Markdown — tables, task lists, strikethrough, fenced code blocks
- Syntax-highlighted code blocks — automatic language detection
- Fully customizable themes — built-in theme editor, unlimited user themes, custom CSS
- Live file watching — re-renders on every save, scroll position preserved
- Vim navigation keys —
j/k,Ctrl+d/u,gg/G,]]/[[ - Find in document — with match count and vim-style
/,n,N - YAML frontmatter — hide, show as a metadata table, or render as Markdown
- Open in external editor — configure any editor or app, one click from the toolbar
- Automatic updates — stays current via Sparkle
Keyboard Shortcuts
| Key | Action |
|---|---|
j / k |
Scroll down / up |
Ctrl+d / Ctrl+u |
Half page down / up |
gg / G |
Top / bottom of document |
]] / [[ |
Next / previous heading |
⌘F |
Find |
/ |
Focus find bar (vim-style) |
n / N |
Next / previous match |
⌘⇧↓ / ⌘⇧↑ |
Next / previous theme |
Building from Source
Requires Xcode 15+, XcodeGen, and just.
git clone https://github.com/darinkelkhoff/markdownViewr.git
cd markdownViewr
just run
just --list shows all available recipes.
Description
macOS markdown viewer with customizable themes
3.7 MiB
0 Stars
2 Watchers
0 Forks
Languages
Swift
83.4%
HTML
13%
Just
2.6%
Python
1%
