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.

Schnellstart — Claude Code

Ein Befehl, um MarkView in jede Claude Code-Sitzung einzubinden:

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

Das 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.

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) oder claude_desktop_config.json (Claude Desktop), nicht in ~/.claude/settings.json.

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 markview

Aus 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 release

Als App installieren (Unterstützung für „Öffnen mit“)

bash scripts/bundle.sh --install

Erstellt MarkView.app in /Applications und registriert es bei Launch Services für Rechtsklick > Öffnen mit im Finder.

CLI installieren

bash scripts/install-cli.sh

Erstellt mdpreview- und md-Symlinks in ~/.local/bin/.

Verwendung

CLI

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

Finder

Rechtsklick auf eine beliebige .md-, .markdown-, .mdown-, .mkd-Datei > Öffnen mit > MarkView

Programmatisch

open -a MarkView README.md

Funktionen

• 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 öffnen

• Markdown-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 ![](./image.png) korrekt ein

• Export 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 öffnen

• Suchen & 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 CLI

Siehe 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 tests

Entwicklung

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

Unterstützung

• GitHub Sponsors

• Geben Sie diesem Repo einen Stern, damit andere es leichter finden

Lizenz

MIT — siehe LICENSE.