Markview

MarkView

Claude Code 用の MCP サーバーを備えた、macOS ネイティブの Markdown プレビューアプリです。Claude が Markdown を書くと、MarkView が作業中にリアルタイムで、ネイティブウィンドウに表示します。

バージョン： macOS アプリ（app バッジ）と npm MCP ラッパー（npm バッジ）は、個別にバージョン管理されています。アプリのリリースは Swift バイナリの変更時に行われ、npm のパッチリリースは MCP サーバーの改善時に行われます。両方のバッジには、それぞれ常に最新バージョンが表示されます。

プレビューのみ	エディター＋プレビュー

クイックスタート — Claude Code

1 つのコマンドで、すべての Claude Code セッションに MarkView を設定できます。

claude mcp add --transport stdio --scope user markview -- npx mcp-server-markview

これで完了です。Claude は preview_markdown を呼び出して任意の Markdown 文字列を macOS ネイティブウィンドウに表示したり、open_file を呼び出して任意の .md ファイルを直接開いたりできます。

ツール	機能
preview_markdown	Markdown コンテンツを、ライブリロード対応の MarkView ウィンドウに表示します
open_file	既存の .md ファイルを MarkView で開きます

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "markview": {
      "command": "npx",
      "args": ["mcp-server-markview"]
    }
  }
}

注： MCP サーバーの設定先は ~/.claude.json（Claude Code）または claude_desktop_config.json（Claude Desktop）です。~/.claude/settings.json ではありません。

インストール

Homebrew（推奨）

# Full .app with Quick Look extension — Apple notarized, Gatekeeper approved
brew install --cask paulhkang94/markview/markview

# CLI only (builds from source)
brew tap paulhkang94/markview
brew install markview

ソースからビルド

前提条件： macOS 14 以降、Swift 6.0 以降（Xcode Command Line Tools）

git clone https://github.com/paulhkang94/markview.git
cd markview
swift build -c release

アプリとしてインストール（「このアプリケーションで開く」に対応）

bash scripts/bundle.sh --install

/Applications に MarkView.app を作成し、Launch Services に登録します。これにより、Finder で右クリックして「このアプリケーションで開く」を選択できます。Dock のタイルが build/ またはリポジトリのルートにある MarkView.app を参照している場合、どちらも一時的な開発用出力であるため、--force を指定しない限りインストールを拒否します。

CLI をインストール

bash scripts/install-cli.sh

~/.local/bin/ に mdpreview と md のシンボリックリンクを作成します。

使い方

CLI

mdpreview README.md       # Open a file
mdpreview                 # Open empty editor

Finder

任意の .md、.markdown、.mdown、.mkd ファイルを右クリック > このアプリケーションで開く > MarkView

プログラムからの使用

open -a MarkView README.md

機能

• GitHub Flavored Markdown（swift-cmark を使用。テーブル、取り消し線、自動リンク、タスクリスト、脚注に対応）
• Mermaid 図 — フローチャート、シーケンス図、ガントチャート、ER 図、円グラフ
• 構文ハイライト（Prism.js を使用。18 言語に対応）
• クイックルック連携 — アプリを開かずに、Finder で .md ファイルをスペースキーでプレビュー
• Markdown の lint — 9 つの組み込みルールとステータスバーでの診断
• ライブ分割ペインエディター — WKWebView によるレンダリングと双方向のスクロール同期
• ファイル監視（DispatchSource を使用）— VS Code、Vim、その他のエディターで動作
• ローカル画像のレンダリング — ![](./image.png) のような相対パスを正しくインライン表示
• HTML と PDF へのエクスポート
• HTML サニタイザー — スクリプト、イベントハンドラー、XSS の攻撃経路を除去
• ドラッグ＆ドロップ — 任意の .md ファイルをウィンドウにドロップして開く
• 検索と置換 — Cmd+F / Cmd+Option+F
• 保存時のフォーマット — lint の修正を自動適用
• 自動保存、単語数、行番号、スクロール位置の保持
• ダークモード — システム／ライト／ダークのテーマオプション、18 個の設定項目

アーキテクチャ

Sources/MarkViewCore/           # Library (no UI, fully testable)
  MarkdownRenderer.swift        # cmark-gfm C API wrapper
  FileWatcher.swift             # DispatchSource file monitoring
  MarkdownLinter.swift          # 9-rule pure Swift linting engine
  HTMLSanitizer.swift           # XSS prevention
  LanguagePlugin.swift          # Plugin protocol + registry
  Plugins/                      # CSV, HTML, Markdown plugins

Sources/MarkView/               # SwiftUI app (macOS 14+)
  ContentView.swift             # Split-pane editor + preview
  WebPreviewView.swift          # WKWebView with Prism.js
  ExportManager.swift           # HTML/PDF export

Sources/MarkViewMCPServer/      # MCP server for AI tool integration
  main.swift                    # stdio JSON-RPC (preview_markdown, open_file)

Tests/TestRunner/               # 403 standalone tests (no XCTest)
Tests/VisualTester/             # 5 visual regression tests + WCAG contrast
Tests/FuzzTester/               # 10K random input crash testing
Tests/DiffTester/               # Differential testing vs cmark-gfm CLI

詳細については、docs/ARCHITECTURE.md を参照してください。

テスト

swift run MarkViewTestRunner    # 403 tests
python3 scripts/verify.py       # Full verification (build + tests, writes stamp)
python3 scripts/verify.py --extended  # + fuzz + differential
bash scripts/test-mcp.sh        # MCP protocol tests

開発

swift build
swift run MarkView
swift run MarkView /path/to/file.md

サポート

• GitHub Sponsors
• このリポジトリにスターを付けて、ほかの人にも見つけてもらいましょう

ライセンス

MIT — LICENSE を参照してください。