Absortio

Email → Summary → Bookmark → Email

GitHub - jahala/mrkd: A native macOS markdown viewer with iTerm2/vscode theme support

https://github.com/jahala/mrkd Mar 1, 2026 21:29

Extracto

A native macOS markdown viewer with iTerm2/vscode theme support - jahala/mrkd

Resumen

Resumen Principal

mrkd se presenta como un visor de Markdown nativo para macOS que redefine la experiencia de visualización de archivos .md al priorizar el rendimiento, la ligereza y una integración impecable con el ecosistema de Apple. Su desarrollo se basa en AppKit y TextKit 2, componentes fundamentales del framework de macOS, lo que le permite ofrecer una sensación de aplicación de primera parte y un rendimiento superior. A diferencia de soluciones basadas en Electron o WebView, mrkd evita la sobrecarga de recursos, resultando en un binario de aproximadamente 1MB. El análisis de Markdown se realiza con cmark-gfm, un parser optimizado para GitHub Flavored Markdown, y la renderización directa a NSAttributedString a través de TextKit 2 garantiza una selección de texto nativa y una accesibilidad robusta. Este enfoque técnico no solo promete velocidad y eficiencia, sino también una interfaz fluida y una compatibilidad total con las funcionalidades del sistema operativo, estableciendo un nuevo estándar para visores de Markdown en Mac.

Elementos Clave

  • Arquitectura Nativa y Rendimiento Superior: mrkd se distingue por su construcción exclusiva con AppKit y TextKit 2, las tecnologías nativas de macOS para interfaces y renderizado de texto. Este enfoque elimina la necesidad de entornos basados en web como Electron o WebView, lo que se traduce en un tamaño binario mínimo (aproximadamente 1MB) y una velocidad y eficiencia excepcionales. La implementación directa del renderizado de cmark-gfm a NSAttributedString asegura una experiencia de usuario fluida y reactiva.
  • Extensas Opciones de Personalización Visual: La aplicación ofrece una gran flexibilidad en su apariencia, permitiendo a los usuarios elegir entre temas preinstalados o importar sus propios temas de iTerm2 (.itermcolors) o VS Code (.json). Además, su soporte para fuentes variables y la posibilidad de configurar fuentes específicas para el cuerpo del texto y el código (como Geist, Inter, iA Writer Mono o JetBrains Mono) brindan una personalización tipográfica profunda.
  • Integración Profunda con el Ecosistema macOS: mrkd está diseñado para sentirse como una extensión natural del sistema operativo. Incluye funcionalidades clave de macOS como Quick Look, que permite previsualizar archivos Markdown directamente en Finder con el tema y las fuentes seleccionadas, y la opción "Open With" para enviar el archivo actual a cualquier otra aplicación con un solo clic. También soporta arrastrar y soltar archivos en el icono del Dock y atajos de teclado estándar para una navegación y edición eficientes.
  • Compromiso con la Accesibilidad: La aplicación ha sido desarrollada pensando en la inclusividad, incorporando una serie de características de accesibilidad nativas de macOS. Entre ellas se incluyen VoiceOver para usuarios con discapacidad visual, Acceso Total al Teclado para una navegación sin ratón, y opciones para Aumentar Contraste y Reducir Transparencia, asegurando que sea utilizable por una amplia gama de usuarios.

Análisis e Implicaciones

mrkd establece un fuerte precedente en el mercado de visores de Markdown al priorizar una experiencia de usuario nativa y de alto rendimiento. Su enfoque en la eficiencia y la integración profunda con macOS sugiere que la demanda de aplicaciones ligeras y especializadas sigue siendo alta, ofreciendo una alternativa robusta a las soluciones más pesadas basadas en frameworks multiplataforma. Esto implica una mayor fidelidad del usuario y una diferenciación clara en la calidad de la interacción.

Contexto Adicional

El proyecto es de código abierto, distribuido bajo la licencia MIT, lo que fomenta la transparencia y la contribución comunitaria. Requiere macOS 15.0+ y Xcode 16+ para su construcción, alineándose con las últimas versiones del sistema operativo y herramientas de desarrollo de Apple.

Contenido

mrkd

A native macOS markdown viewer built with AppKit and TextKit 2. Fast, lightweight, and designed to feel like a first-party Mac app.

No Electron. No WebView. Markdown is parsed with cmark-gfm and rendered directly to NSAttributedString via TextKit 2 -- native text selection, native accessibility, ~1MB binary.

Features

  • Native rendering -- GFM markdown via cmark-gfm, styled with NSAttributedString
  • Themes -- Built-in themes and import your own from iTerm2 or VS Code
  • Typography -- Variable font support with configurable body and code fonts (Geist, Inter, iA Writer Mono, JetBrains Mono, and more)
  • Open With -- Send the current file to any app on your Mac with one click
  • Quick Look -- Preview markdown files in Finder with your selected theme, fonts, and an Open button
  • Performance -- Tiered rendering pipeline for files of any size
  • Accessibility -- VoiceOver, Full Keyboard Access, Increase Contrast, Reduce Transparency

Requirements

  • macOS 15.0+
  • Xcode 16+

Building

git clone https://github.com/jahala/mrkd.git
cd mrkd
open mrkd.xcodeproj

Build and run the mrkd scheme in Xcode. Code signing is set to Automatic -- Xcode will use your own developer identity.

Usage

Open any .md, .markdown, or .mdown file with mrkd. You can also drag files onto the Dock icon or use File > Open.

Keyboard shortcuts:

  • Cmd + / Cmd - / Cmd 0 -- Adjust font size
  • Cmd O -- Open file
  • Space / Shift-Space -- Page down / up

Settings (Cmd ,): Choose a theme, body font, and code font. Import custom themes from iTerm2 .itermcolors or VS Code .json theme files.

License

MIT. See LICENSE.

Bundled fonts are distributed under their respective open-source licenses (SIL OFL 1.1 or Apache 2.0).

Fuente: GitHub