markview
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 (insignianpm) 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.

Solo vista previa | Editor + Vista previa |
|
|
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-markviewEso 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.
Herramienta | Qué hace |
| Renderiza contenido markdown en una ventana de MarkView con recarga en vivo |
| Abre un archivo |
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) oclaude_desktop_config.json(Claude Desktop), no a~/.claude/settings.json.
Related MCP server: Inkra MCP
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 markviewConstruir 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 releaseInstalar como aplicación (soporte para Abrir con)
bash scripts/bundle.sh --installCrea MarkView.app en /Applications y lo registra en Launch Services para clic derecho > Abrir con en Finder.
Instalar CLI
bash scripts/install-cli.shCrea enlaces simbólicos mdpreview y md en ~/.local/bin/.
Uso
CLI
mdpreview README.md # Open a file
mdpreview # Open empty editorFinder
Clic derecho en cualquier archivo .md, .markdown, .mdown, .mkd > Abrir con > MarkView
Programático
open -a MarkView README.mdCaracterí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
.mden Finder sin abrir la aplicaciónLinting 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
correctamenteExportar a HTML y PDF
Sanitizador HTML — elimina scripts, controladores de eventos y vectores XSS
Arrastrar y soltar — suelta cualquier archivo
.mden la ventana para abrirloBuscar 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 CLIConsulta 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 testsDesarrollo
swift build
swift run MarkView
swift run MarkView /path/to/file.mdSoporte
Marca este repositorio con una estrella para ayudar a otros a encontrarlo
Licencia
MIT — ver 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

