MarkView

Vista previa de markdown nativa para macOS con servidor MCP para Claude Code. Claude escribe markdown — MarkView lo renderiza en vivo, en una ventana nativa real, mientras trabajas.

Versiones: La aplicación de macOS (insignia app) y el envoltorio MCP de npm (insignia npm) tienen versiones independientes. Las versiones de la aplicación ocurren cuando cambia el binario de Swift; los parches de npm ocurren para mejoras del servidor MCP. Ambas insignias siempre muestran lo último de cada una.

Inicio rápido — Claude Code

Un comando para conectar MarkView en cada sesión de Claude Code:

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

Eso es todo. Claude ahora puede llamar a preview_markdown para renderizar cualquier cadena de markdown en una ventana nativa de macOS, o open_file para abrir cualquier archivo .md directamente.

Configuración de Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "markview": {
      "command": "npx",
      "args": ["mcp-server-markview"]
    }
  }
}

Nota: Los servidores MCP pertenecen a ~/.claude.json (Claude Code) o claude_desktop_config.json (Claude Desktop), no a ~/.claude/settings.json.

Instalación

Homebrew (recomendado)

# 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

Construir desde el código fuente

Requisitos previos: macOS 14+, Swift 6.0+ (Herramientas de línea de comandos de Xcode)

git clone https://github.com/paulhkang94/markview.git
cd markview
swift build -c release

Instalar como aplicación (soporte para Abrir con)

bash scripts/bundle.sh --install

Crea MarkView.app en /Applications y lo registra en Launch Services para clic derecho > Abrir con en Finder.

Instalar CLI

bash scripts/install-cli.sh

Crea enlaces simbólicos mdpreview y md en ~/.local/bin/.

Uso

CLI

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

Finder

Clic derecho en cualquier archivo .md, .markdown, .mdown, .mkd > Abrir con > MarkView

Programático

open -a MarkView README.md

Características

• GitHub Flavored Markdown mediante swift-cmark (tablas, tachado, enlaces automáticos, listas de tareas, notas al pie)

• Diagramas Mermaid — diagramas de flujo, secuencia, Gantt, ER y gráficos circulares

• Resaltado de sintaxis mediante Prism.js (18 lenguajes)

• Integración con Quick Look — vista previa con la barra espaciadora de archivos .md en Finder sin abrir la aplicación

• Linting de Markdown con 9 reglas integradas y diagnósticos en la barra de estado

• Editor de panel dividido en vivo con renderizado WKWebView y sincronización de desplazamiento bidireccional

• Monitoreo de archivos con DispatchSource — funciona con VS Code, Vim y otros editores

• Renderizado de imágenes locales — inserta rutas relativas como ![](./image.png) correctamente

• Exportar a HTML y PDF

• Sanitizador HTML — elimina scripts, controladores de eventos y vectores XSS

• Arrastrar y soltar — suelta cualquier archivo .md en la ventana para abrirlo

• Buscar y reemplazar — Cmd+F / Cmd+Option+F

• Formatear al guardar — aplica automáticamente correcciones de lint

• Guardado automático, conteo de palabras, números de línea, preservación de la posición de desplazamiento

• Modo oscuro — opciones de tema sistema/claro/oscuro, 18 configuraciones configurables

Arquitectura

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

Consulta docs/ARCHITECTURE.md para obtener todos los detalles.

Pruebas

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

Desarrollo

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

Soporte

• GitHub Sponsors

• Marca este repositorio con una estrella para ayudar a otros a encontrarlo

Licencia

MIT — ver LICENSE.