paulhkang94/markview

&color=green)
Native macOS markdown preview with MCP server for Claude Code. Claude writes markdown — MarkView renders it live, in a real native window, while you work.
> **Versions:** The macOS app (app badge) and the npm MCP wrapper (npm badge) are versioned independently. App releases happen when the Swift binary changes; npm patches happen for MCP server improvements. Both badges always show the latest of each.
| Preview only | Editor + Preview |
|:---:|:---:|
| | |
Quick Start — Claude Code
One command to wire MarkView into every Claude Code session:
That's it. Claude can now call preview_markdown to render any markdown string in a native macOS window, or open_file to open any .md file directly.
| Tool | What it does |
|------|-------------|
| preview_markdown | Render markdown content in a live-reloading MarkView window |
| open_file | Open an existing .md file in MarkView |
Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
> **Note:** MCP servers belong in ~/.claude.json (Claude Code) or claude_desktop_config.json (Claude Desktop), not ~/.claude/settings.json.
Installation
Homebrew (recommended)
Build from source
**Prerequisites:** macOS 14+, Swift 6.0+ (Xcode Command Line Tools)
Install as app (Open With support)
Creates MarkView.app in /Applications and registers it with Launch Services for right-click > Open With in Finder. Refuses (unless you pass --force) if a Dock tile is pinned to a build/ or repo-root MarkView.app path, since both are ephemeral dev output.
Install CLI
Creates mdpreview and md symlinks in ~/.local/bin/.
Usage
CLI
Finder
Right-click any .md, .markdown, .mdown, .mkd file > **Open With** > **MarkView**
Programmatic
Features
- **GitHub Flavored Markdown** via swift-cmark (tables, strikethrough, autolinks, task lists, footnotes)
- **Mermaid diagrams** — flowcharts, sequence, Gantt, ER, and pie charts
- **Syntax highlighting** via Prism.js (18 languages)
- **Quick Look integration** — spacebar-preview .md files in Finder without opening the app
- **Markdown linting** with 9 built-in rules and status bar diagnostics
- **Live split-pane editor** with WKWebView rendering and bidirectional scroll sync
- **File watching** with DispatchSource — works with VS Code, Vim, and other editors
- **Local image rendering** — inlines relative paths like correctly