MarkView

App npm Glama

Нативный просмотрщик Markdown для macOS с MCP-сервером для Claude Code. Claude пишет Markdown — MarkView отображает его в реальном времени в настоящем нативном окне, пока вы работаете.

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

Демонстрация MarkView

Только просмотр	Редактор + Просмотр

Быстрый старт — 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 напрямую.

Инструмент	Что он делает
`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

Создает 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 editor

Finder

Нажмите правой кнопкой мыши на любой файл .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 и другими редакторами
Отображение локальных изображений — корректно встраивает относительные пути, такие как ![](./image.png)
Экспорт в 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

Поддержка

GitHub Sponsors
Поставьте звезду этому репозиторию, чтобы помочь другим найти его

Лицензия

MIT — см. LICENSE.

markview