Darin KelkhoffandClaude Sonnet 4.6 2631fc5ff2 add theme import/export, schema versioning, migration, unit tests, Homebrew cask
- 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>
2026-06-09 13:55:34 -05:00
2026-06-08 12:01:59 -05:00
2026-03-26 08:32:36 -05:00

markdownViewr

A fast, beautiful markdown viewer for macOS. Open any markdown file — it live-reloads as you edit in your favorite editor.

Download macOS 13+ Free

markdownViewr screenshot

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.

S
Description
macOS markdown viewer with customizable themes
Readme MIT
3.7 MiB
0 Stars 2 Watchers 0 Forks
Languages
Swift 83.4%
HTML 13%
Just 2.6%
Python 1%