markview
MarkView
Nativer macOS Markdown-Vorschau-Viewer mit MCP-Server für Claude Code. Claude schreibt Markdown — MarkView rendert es live in einem echten nativen Fenster, während Sie arbeiten.
Versionen: Die macOS-App (
app-Badge) und der npm-MCP-Wrapper (npm-Badge) werden unabhängig voneinander versioniert. App-Releases erfolgen, wenn sich das Swift-Binary ändert; npm-Patches erfolgen bei Verbesserungen am MCP-Server. Beide Badges zeigen immer die jeweils neueste Version an.

Nur Vorschau | Editor + Vorschau |
|
|
Schnellstart — Claude Code
Ein Befehl, um MarkView in jede Claude Code-Sitzung einzubinden:
claude mcp add --transport stdio --scope user markview -- npx mcp-server-markviewDas ist alles. Claude kann nun preview_markdown aufrufen, um jeden Markdown-String in einem nativen macOS-Fenster zu rendern, oder open_file, um jede .md-Datei direkt zu öffnen.
Tool | Was es tut |
| Rendert Markdown-Inhalte in einem MarkView-Fenster mit Live-Aktualisierung |
| Öffnet eine vorhandene |
Einrichtung für Claude Desktop
Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:
{
"mcpServers": {
"markview": {
"command": "npx",
"args": ["mcp-server-markview"]
}
}
}Hinweis: MCP-Server gehören in
~/.claude.json(Claude Code) oderclaude_desktop_config.json(Claude Desktop), nicht in~/.claude/settings.json.
Related MCP server: Inkra MCP
Installation
Homebrew (empfohlen)
# 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 markviewAus Quellcode erstellen
Voraussetzungen: macOS 14+, Swift 6.0+ (Xcode Command Line Tools)
git clone https://github.com/paulhkang94/markview.git
cd markview
swift build -c releaseAls App installieren (Unterstützung für „Öffnen mit“)
bash scripts/bundle.sh --installErstellt MarkView.app in /Applications und registriert es bei Launch Services für Rechtsklick > Öffnen mit im Finder.
CLI installieren
bash scripts/install-cli.shErstellt mdpreview- und md-Symlinks in ~/.local/bin/.
Verwendung
CLI
mdpreview README.md # Open a file
mdpreview # Open empty editorFinder
Rechtsklick auf eine beliebige .md-, .markdown-, .mdown-, .mkd-Datei > Öffnen mit > MarkView
Programmatisch
open -a MarkView README.mdFunktionen
GitHub Flavored Markdown via swift-cmark (Tabellen, Durchstreichen, Autolinks, Aufgabenlisten, Fußnoten)
Mermaid-Diagramme — Flussdiagramme, Sequenz-, Gantt-, ER- und Tortendiagramme
Syntax-Hervorhebung via Prism.js (18 Sprachen)
Quick Look-Integration — Leertasten-Vorschau für
.md-Dateien im Finder, ohne die App zu öffnenMarkdown-Linting mit 9 integrierten Regeln und Statusleisten-Diagnose
Live-Editor mit geteiltem Fenster mit WKWebView-Rendering und bidirektionaler Scroll-Synchronisierung
Dateiüberwachung mit DispatchSource — funktioniert mit VS Code, Vim und anderen Editoren
Lokales Bild-Rendering — bindet relative Pfade wie
korrekt einExport nach HTML und PDF
HTML-Sanitizer — entfernt Skripte, Event-Handler und XSS-Vektoren
Drag & Drop — ziehen Sie eine beliebige
.md-Datei in das Fenster, um sie zu öffnenSuchen & Ersetzen — Cmd+F / Cmd+Option+F
Formatieren beim Speichern — wendet Lint-Korrekturen automatisch an
Automatisches Speichern, Wortanzahl, Zeilennummern, Beibehaltung der Scroll-Position
Dunkelmodus — System-/Hell-/Dunkel-Design-Optionen, 18 konfigurierbare Einstellungen
Architektur
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 CLISiehe docs/ARCHITECTURE.md für vollständige Details.
Testen
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 testsEntwicklung
swift build
swift run MarkView
swift run MarkView /path/to/file.mdUnterstützung
Geben Sie diesem Repo einen Stern, damit andere es leichter finden
Lizenz
MIT — siehe 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

