markview
MarkView
Нативный просмотрщик Markdown для macOS с MCP-сервером для Claude Code. Claude пишет Markdown — MarkView отображает его в реальном времени в настоящем нативном окне, пока вы работаете.
Версии: Приложение для macOS (значок
app) и npm-обертка MCP (значокnpm) имеют независимую нумерацию версий. Релизы приложения выходят при изменении Swift-бинарного файла; патчи npm выходят при улучшениях MCP-сервера. Оба значка всегда показывают актуальную версию для каждого компонента.

Только просмотр | Редактор + Просмотр |
|
|
Быстрый старт — Claude Code
Одна команда для подключения MarkView к любому сеансу Claude Code:
claude mcp add --transport stdio --scope user markview -- npx mcp-server-markviewВот и всё. Теперь Claude может вызывать preview_markdown для отображения любой строки Markdown в нативном окне macOS или open_file для открытия любого файла .md напрямую.
Инструмент | Что он делает |
| Отображает содержимое Markdown в окне 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.
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Создает MarkView.app в /Applications и регистрирует его в Launch Services для использования функции «Открыть с помощью» по правому клику в Finder.
Установка CLI
bash scripts/install-cli.shСоздает символические ссылки mdpreview и md в ~/.local/bin/.
Использование
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 — предварительный просмотр файлов
.mdпо нажатию пробела в Finder без открытия приложенияЛинтинг Markdown с 9 встроенными правилами и диагностикой в строке состояния
Редактор с разделением экрана с рендерингом через WKWebView и двусторонней синхронизацией прокрутки
Отслеживание файлов через DispatchSource — работает с VS Code, Vim и другими редакторами
Отображение локальных изображений — корректно встраивает относительные пути, такие как
Экспорт в HTML и PDF
HTML-санитайзер — удаляет скрипты, обработчики событий и векторы XSS
Drag and drop — перетащите любой файл
.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

