QL Markdown by XN

QL Markdown es una extensión para macOS que muestra archivos Markdown en la Vista rápida (Quick Look) del Finder con una calidad equivalente a la de GitHub. Solo tienes que seleccionar un archivo .md y pulsar la barra espaciadora: aparece al instante una vista previa limpia y bien formateada, sin necesidad de abrir otra aplicación.

■ Formatos compatibles

Extensiones .md, .markdown, .mdown, .mkd

■ Funciones principales

• Compatibilidad total con GitHub Flavored Markdown (GFM): tablas, casillas de verificación, enlaces automáticos, texto tachado

• Detección automática del YAML Front Matter, mostrado como una tabla ordenada al principio del documento

• Notas al pie y listas de definiciones

• Renderizado de fórmulas con KaTeX: reconoce $...$, $$...$$, \(...\) y \[...\]

• Diagramas de Mermaid: flujos, secuencia, Gantt, clases, etc.

• Resaltado de sintaxis con highlight.js (más de 190 lenguajes)

• Seguimiento automático del modo claro/oscuro: la vista previa cambia al instante cuando lo hace la apariencia del sistema

■ Funcionamiento totalmente local (aislado de la red)

Todas las fuentes, scripts y hojas de estilo están incluidos dentro de la app. Todas las funciones se comportan igual sin conexión a internet, y no se envía ninguna petición a servidores externos. Las peticiones http/https se bloquean por partida doble mediante Content Security Policy (CSP) y WKContentRuleList, por lo que puedes utilizar la app con total tranquilidad en entornos seguros.

■ Compatible con App Sandbox

Cumple con el App Sandbox y el Hardened Runtime de Apple. La app no accede a ningún archivo más allá de los que el usuario selecciona explícitamente.

■ Compatibilidad con imágenes locales (opcional)

Cuando un documento Markdown hace referencia a imágenes de la misma carpeta (por ejemplo, ), basta con conceder permiso de lectura a esa carpeta una sola vez desde el botón "Conceder acceso a carpeta…" de la app anfitriona para que las imágenes también aparezcan en Quick Look. Si no se concede acceso, se muestra un marcador de posición con borde punteado junto al texto alternativo, de modo que puedes identificar al instante qué imagen falta. Las imágenes http/https se bloquean conforme a la política de red.

■ Gestión de archivos grandes

Se procesan archivos Markdown de hasta 5 MB. Los archivos más grandes se truncan en una frontera de línea y un aviso en la parte superior indica que el contenido ha sido recortado.

Los bloques de código o fórmulas truncados se cierran automáticamente, por lo que la salida nunca queda rota.

■ Detección automática de codificaciones coreana / japonesa / china

Además de UTF-8, los archivos guardados en UTF-16 (con BOM), Shift-JIS o EUC-KR se detectan automáticamente y se muestran correctamente.

■ Cómo usar la app

1. Abre la app una vez para registrar la extensión de Quick Look.

2. Selecciona un archivo .md en el Finder y pulsa la barra espaciadora.

3. (Opcional) Para ver imágenes locales, concede acceso a la carpeta desde el botón "Conceder acceso a carpeta…" de la app anfitriona.

■ Requisitos del sistema

• macOS 14.0 (Sonoma) o posterior

• Binario universal: Macs con Apple Silicon e Intel

■ Licencias de código abierto

El texto completo de las licencias de las bibliotecas de terceros incluidas (cmark-gfm, highlight.js, KaTeX, Mermaid, github-markdown-css) está disponible en el menú de la app, en Ayuda → "Licencias de código abierto".