markview
MarkView
Claude Code用MCPサーバーを備えたmacOSネイティブのMarkdownプレビューアです。ClaudeがMarkdownを書くと、MarkViewが作業中にリアルタイムでネイティブウィンドウにレンダリングします。
バージョンについて: macOSアプリ(
appバッジ)とnpm MCPラッパー(npmバッジ)は個別にバージョン管理されています。アプリのリリースはSwiftバイナリが変更された際に行われ、npmのパッチはMCPサーバーの改善時に行われます。両方のバッジには常にそれぞれの最新バージョンが表示されます。

プレビューのみ | エディタ + プレビュー |
|
|
クイックスタート — Claude Code
1つのコマンドでMarkViewをすべてのClaude Codeセッションに組み込めます:
claude mcp add --transport stdio --scope user markview -- npx mcp-server-markview以上です。これでClaudeは preview_markdown を呼び出して任意のMarkdown文字列をmacOSネイティブウィンドウでレンダリングしたり、 open_file を呼び出して .md ファイルを直接開いたりできるようになります。
ツール | 機能 |
| ライブリロード可能なMarkViewウィンドウでMarkdownコンテンツをレンダリング |
| 既存の |
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ではありません。
Related MCP server: Inkra MCP
インストール
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 を作成し、Finderの右クリック > 「このアプリケーションで開く」に登録します。
CLIのインストール
bash scripts/install-cli.sh~/.local/bin/ に mdpreview および md シンボリックリンクを作成します。
使用方法
CLI
mdpreview README.md # Open a file
mdpreview # Open empty editorFinder
任意の .md, .markdown, .mdown, .mkd ファイルを右クリック > このアプリケーションで開く > MarkView
プログラムからの利用
open -a MarkView README.md機能
GitHub Flavored Markdown 対応 (swift-cmark使用: テーブル、取り消し線、自動リンク、タスクリスト、脚注)
Mermaidダイアグラム — フローチャート、シーケンス図、ガントチャート、ER図、円グラフ
シンタックスハイライト — Prism.js使用 (18言語)
Quick Look統合 — Finderでスペースキーを押してアプリを開かずに
.mdファイルをプレビューMarkdownリンティング — 9つの組み込みルールとステータスバーでの診断表示
ライブ分割ペインエディタ — WKWebViewレンダリングと双方向スクロール同期
ファイル監視 — DispatchSource使用 (VS Code、Vim、その他のエディタで動作)
ローカル画像レンダリング —
のような相対パスを正しくインライン表示エクスポート — HTMLおよびPDF形式
HTMLサニタイザー — スクリプト、イベントハンドラ、XSSベクターを除去
ドラッグ&ドロップ — ウィンドウに
.mdファイルをドロップして開く検索&置換 — Cmd+F / Cmd+Option+F
保存時にフォーマット — リンターの修正を自動適用
自動保存、単語数カウント、行番号表示、スクロール位置の保持
ダークモード — システム/ライト/ダークテーマのオプション、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
bash verify.sh # Full verification (build + tests)
bash verify.sh --extended # + fuzz + differential
bash scripts/test-mcp.sh # MCP protocol tests開発
swift build
swift run MarkView
swift run MarkView /path/to/file.mdサポート
このリポジトリにスターを付けて、他の人が見つけやすくしてください
ライセンス
MIT — LICENSE を参照してください。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free Markdown notes app, Mac and iPhone. Sync ($5.99/mo) adds a personal MCP endpoint for your AI.
Screenshot any URL, HTML or Markdown in a real browser, and read web pages as Markdown.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Convert Markdown to PDF, DOCX, HTML or EPUB with formatting and display options.
Related MCP Servers
- AlicenseAqualityBmaintenanceMarkdown collaboration for AI workflows. Share markdown via public links with four permission levels, inline comments, and real-time sync. AI agents can read docs, review comments, incorporate feedback, and resolve threads. Free, no login.149MIT
- AlicenseAqualityBmaintenanceMCP bridge for Inkra — drive a native macOS Markdown editor (SwiftUI + AppKit, not Electron) with live KaTeX/Mermaid preview from Claude, Cursor, or any MCP client. 18 tools across document editing, outline navigation, folder browsing, bookmarks, themes, and focus/wide view modes. Bridge open-source (MIT), Inkra app available on Mac App Store and direct download.181MIT
- AlicenseAqualityCmaintenanceConverts documents between Markdown, PDF, DOCX, and HTML locally with AI-friendly Markdown output and secure file access.6MIT
- AlicenseNot gradedqualityCmaintenanceConverts PDFs, Office files, spreadsheets, emails, audio, and more to Markdown locally, enabling AI assistants to read and process them without cloud upload.MIT

