showmd

¿Qué es showmd?

showmd es una extensión gratuita de Quick Look para macOS que previsualiza archivos Markdown (.md y extensiones relacionadas) de forma más legible que el comportamiento predeterminado de Finder. Su propósito principal es renderizar Markdown con formato, manteniendo el acceso al contenido fuente.

En lugar de mostrar texto crudo al pulsar Espacio en un archivo .md en Finder, showmd renderiza Markdown y ofrece un conmutador renderizado/fuente. Además, analiza el frontmatter YAML en una tabla de metadatos plegable, compatible con flujos de trabajo comunes de documentación y prompts de IA que dependen de la estructura Markdown.

Características principales

• Previsualización Quick Look para Markdown en Finder: Pulsa Espacio en un archivo Markdown para ver la salida formateada sin abrir un navegador o editor.
• Conmutador renderizado ↔ fuente: Cambia entre Markdown renderizado y el fuente Markdown crudo con un solo clic.
• Frontmatter YAML como tabla de metadatos plegable: Detecta “claves encontradas” en el frontmatter y las muestra en una tabla plegada por defecto.
• Funciones Markdown mediante un analizador Markdown: Soporta elementos de GitHub Flavored Markdown como tablas, listas de tareas, tachado, autovínculos, notas al pie y más.
• Renderizado consciente de sintaxis para código y contenido especial: Los bloques de código usan resaltado por lenguaje (190+ idiomas listados), LaTeX math en línea y en bloque se renderiza vía KaTeX, y diagramas Mermaid se renderizan desde bloques de código.
• Renderizado de etiquetas orientado a IA: Etiquetas similares a XML comunes en prompts de IA (por ejemplo, , , ) se renderizan como bloques con etiquetas y bordes en lugar de corchetes angulares crudos.
• Sin subidas a la nube ni en segundo plano descritas: La página indica “No cloud. No uploads. No telemetry”, lo que significa que los archivos se previsualizan localmente por defecto.
• Manejo de imágenes en línea en Quick Look: Las rutas relativas de imágenes se resuelven correctamente para que capturas/diagramas locales aparezcan en la previsualización.

Cómo usar showmd

1. Descarga showmd para macOS y ábrelo una vez.
2. En Configuración del sistema → Privacidad y seguridad → Extensiones → Quick Look, activa showmd (la página lo describe como un solo conmutador).
3. En Finder, selecciona un archivo Markdown y pulsa Espacio para previsualizarlo con showmd.
4. Usa el conmutador renderizado/fuente para cambiar entre salida formateada y Markdown subyacente. La página también menciona una opción para copiar como HTML.

Casos de uso

• Leer documentación almacenada como Markdown: Previsualiza archivos README con encabezados, listas, vínculos y tablas formateados, sin salir de Finder.
• Inspeccionar archivos de prompts/configuración de IA escritos en Markdown: Ve archivos de instrucciones para agentes de IA donde el contenido incluye etiquetas similares a XML, renderizadas como bloques con etiquetas para escanear más rápido.
• Revisar frontmatter YAML en contenido de sitios estáticos: Expande la tabla de frontmatter cuando necesites verificar títulos o claves de configuración, manteniéndola plegada durante lecturas casuales.
• Comprobar contenido técnico con código, matemáticas o diagramas: Ve bloques de código con resaltado de sintaxis, expresiones LaTeX y diagramas de flujo Mermaid renderizados en línea en lugar de texto crudo.
• Verificar imágenes relativas en notas/docs locales de repos: Confirma que las imágenes referenciadas por rutas relativas aparecen correctamente en la previsualización Quick Look.

Preguntas frecuentes

¿Cómo activo showmd en Finder?
Descarga showmd, ábrelo una vez, luego ve a Configuración del sistema → Privacidad y seguridad → Extensiones → Quick Look y activa la extensión. Al primer lanzamiento, macOS puede pedir permiso para acceder a datos de otras apps; haz clic en Permitir.

¿showmd reemplaza la necesidad de abrir un navegador?
La página presenta showmd como una forma de previsualizar Markdown directamente en Quick Look de macOS, en lugar de abrir un navegador para ver la salida renderizada.

¿Puedo cambiar entre salida renderizada y Markdown original?
Sí. showmd ofrece un conmutador renderizado y fuente, descrito como un solo clic.

¿Cómo maneja showmd el frontmatter YAML?
Lo analiza en una tabla plegable, plegada por defecto, que puedes expandir para ver metadatos.

¿Hay un componente en la nube?
La página indica “No cloud. No uploads. No telemetry”, lo que significa que las previsualizaciones se manejan localmente por defecto.

Alternativas

• Abrir archivos Markdown en un visor/editor dedicado de Markdown: Usa una app diseñada para renderizado y exportación de Markdown. Estas opciones suelen incluir más herramientas de edición, mientras que showmd está posicionado específicamente como previsualizador de Quick Look.
• Usar un renderizador de Markdown basado en navegador: Sube o pega el contenido en un visor en línea para obtener la salida renderizada. Comparado con showmd, esto añade un paso en el navegador y puede no mantener los archivos estrictamente locales.
• Confiar en el Quick Look predeterminado de macOS: La previsualización Espacio del Finder mostrará el código fuente Markdown sin procesar. Es lo más simple, pero menos legible para contenido formateado como tablas, diagramas y matemáticas.
• Usar una cadena de herramientas de documentación/sitio estático para previsualizar contenido: Los servidores de desarrollo locales pueden renderizar Markdown con estilos completos del sitio, pero suelen ser más pesados que un flujo de trabajo de previsualización de Quick Look.