showmd

showmd: La forma más legible de previsualizar archivos Markdown en macOS

El formato Markdown nunca fue diseñado para ser visualizado como simple texto plano. Sin embargo, al usar la función Quick Look nativa de macOS, los archivos .md se muestran como un conjunto desordenado de hashes, asteriscos y guiones. showmd llega para solucionar este problema, ofreciendo la experiencia de visualización de showmd directamente en tu Finder.

¿Qué es showmd?

showmd es un previsualizador de Markdown nativo para macOS, gratuito y de código abierto. No es un editor ni una aplicación de notas; es una herramienta especializada cuyo único propósito es renderizar tus archivos .md de la manera más estética y funcional posible. Con showmd, al presionar la barra espaciadora sobre cualquier archivo Markdown, obtendrás una versión perfectamente formateada en lugar de código bruto.

Este proyecto nace de la necesidad de leer archivos modernos como AGENTS.md, CLAUDE.md o .cursorrules, los cuales suelen estar llenos de etiquetas XML y metadatos que otros visores no logran procesar correctamente. showmd entiende el ecosistema actual de la IA y el desarrollo de software, proporcionando una interfaz limpia y profesional.

Características principales de showmd

El software showmd destaca por una serie de funcionalidades diseñadas para el flujo de trabajo moderno:

• Renderizado de GitHub Flavored Markdown (GFM): Soporte completo para tablas, listas de tareas, tachado, notas al pie y enlaces automáticos gracias al motor swift-markdown de Apple.
• Soporte único para etiquetas de IA: Las etiquetas XML utilizadas por agentes de IA (como <instructions>, <thinking> o <example>) se renderizan como bloques bordeados y etiquetados, eliminando el desorden visual.
• Gestión de YAML Frontmatter: showmd es el único visor que parsea los bloques de metadatos YAML en una tabla colapsable, manteniendo el documento limpio pero accesible.
• Diagramas Mermaid y LaTeX: Visualiza diagramas de flujo, diagramas de secuencia y ecuaciones matemáticas complejas (vía KaTeX) directamente en la vista previa.
• Resaltado de sintaxis: Compatible con más de 190 lenguajes de programación en bloques de código.
• Privacidad total: showmd funciona de forma local. No hay nube, no hay subidas de archivos ni telemetría. Tus datos nunca abandonan tu máquina.
• Integración nativa: Respeta el modo oscuro del sistema, las fuentes de macOS y funciona instantáneamente en menos de un segundo.
• Multiformato: Compatible con extensiones .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd y .mkdn.

Cómo usar showmd

Configurar showmd en tu Mac es un proceso sencillo que consta de tres pasos:

1. Descarga e instalación: Puedes bajar el archivo .dmg firmado y notarizado o instalarlo vía Homebrew con el comando:

   brew install --cask johannesnagl/tap/showmd

2. Habilitar la extensión: Ve a Ajustes del Sistema → Privacidad y Seguridad → Extensiones → Quick Look. Activa la casilla de showmd.
3. Visualización instantánea: Selecciona cualquier archivo .md en el Finder y presiona la Barra Espaciadora. showmd mostrará el contenido renderizado automáticamente.

Nota: En el primer lanzamiento, macOS solicitará permiso para acceder a datos de otras aplicaciones. Haz clic en "Permitir" para que la extensión pueda compartir tus ajustes de configuración.

Casos de uso

El visor showmd es ideal para diversos perfiles profesionales:

• Desarrolladores: Para leer archivos README.md, CHANGELOG.md o documentación técnica sin abrir VS Code.
• Ingenieros de IA: Para revisar archivos de configuración de agentes y prompts estructurados con etiquetas XML de forma clara.
• Científicos y Académicos: Para visualizar notas con ecuaciones en LaTeX y diagramas de flujo Mermaid sin necesidad de compiladores externos.
• Escritores técnicos: Para verificar rápidamente el formato de tablas, alertas de estilo GitHub (NOTE, TIP, WARNING) e imágenes locales vinculadas.

FAQ - Preguntas frecuentes sobre showmd

¿Cómo habilito showmd en el Finder?

Tras descargar y abrir la aplicación por primera vez, debes ir a Ajustes del Sistema > Privacidad y Seguridad > Extensiones > Quick Look y activar showmd. Una vez hecho esto, el sistema usará showmd cada vez que presiones espacio sobre un archivo compatible.

¿Qué sucede con el YAML frontmatter?

showmd lo procesa y lo convierte en una tabla de metadatos que aparece colapsada por defecto al inicio del documento, evitando distracciones pero permitiendo su expansión con un clic.

¿Puedo ver el código fuente original?

Sí. En la parte superior de cada vista previa de showmd, encontrarás un interruptor para cambiar entre la vista "Rendered" (Renderizada) y "Source" (Fuente). También permite copiar el contenido directamente como HTML.

¿Es showmd un editor de texto?

No. showmd es exclusivamente un visor de solo lectura diseñado para ser rápido y eficiente a través de Quick Look.

¿Es showmd gratuito?

Sí, showmd es totalmente gratuito y de código abierto bajo la licencia MIT. Si te resulta útil, puedes apoyar al desarrollador mediante una donación opcional.

¿Qué diferencia a showmd de otras alternativas?

A diferencia de otras opciones de pago o herramientas FOSS incompletas, showmd ofrece un paquete completo que incluye soporte para diagramas Mermaid, LaTeX, etiquetas de IA y una aplicación de ajustes dedicada, todo sin costo y con una instalación simple.