Marky: El Visor Markdown que Necesitan tus Agentes IA

Marky es una aplicación de escritorio CLI-first para macOS, construida con Tauri v2 y React, que te permite visualizar archivos Markdown en tiempo real con un comando desde la terminal. Diseñada específicamente para workflows de agentic coding, resuelve la fricción de abrir archivos generados por agentes de IA a través del explorador tradicional.

En 30 segundos

  • Marky es un visor Markdown nativo para macOS, basado en Tauri v2, que se abre directo desde la terminal con marky ARCHIVO.
  • Soporta GitHub Flavored Markdown completo: tablas, task lists, diagramas Mermaid y ecuaciones matemáticas con KaTeX.
  • Tiene live reload automático: si un agente escribe en el archivo, la vista se actualiza sola sin que toques nada.
  • Usa DOMPurify para sanitizar HTML, lo que importa cuando el contenido lo genera una IA que podés no controlar del todo.
  • Comparado con Typora o StackEdit, está diseñado para desarrolladores y pipelines automatizados, no para escritura manual.

¿Qué es Marky? El visor markdown para agentes IA que faltaba

Marky es una aplicación de escritorio liviana para macOS que te permite abrir y visualizar archivos Markdown directamente desde la terminal, con recarga automática cuando el archivo cambia. Según el repositorio oficial en GitHub, el proyecto nació de una necesidad concreta: los agentes de codificación generan constantemente archivos .md (planes, documentación, reportes) y abrirlos a mano a través del Finder o un editor completo es una fricción innecesaria.

El stack es Tauri v2 para el shell nativo, React para la UI, markdown-it como parser, y DOMPurify para sanitización. Nada de Electron, nada pesado.

Por qué Marky importa en el contexto del agentic coding

Ponele que tenés un agente de IA, Claude Code o cualquier otro, trabajando en un proyecto largo. El agente escribe un PLAN.md con los pasos que va a ejecutar, o genera documentación técnica automáticamente, o produce un reporte con diagramas de arquitectura en Mermaid. ¿Cómo lo visualizás mientras el agente trabaja?

Sin una herramienta como Marky, la respuesta típica es: abrís VS Code, buscás el archivo, activás el preview. Funciona, pero rompe el ritmo del terminal. Hay una tendencia emergente que vale la pena conocer: el formato AGENTS.md, un estándar informal donde los proyectos incluyen un archivo de instrucciones específico para agentes de IA, similar a un CLAUDE.md o GEMINI.md. Estos archivos se leen, modifican y regeneran constantemente durante el desarrollo automatizado. Tener un visor que se actualice solo tiene sentido directo.

La integración CLI-first de Marky encaja exactamente con ese workflow. Abrís el visor una vez, el agente escribe, vos mirás. Sin clicks intermedios.

Características principales y stack tecnológico

Lo que trae Marky, según la documentación del proyecto:

  • Live reload automático: detecta cambios en el archivo y actualiza la vista sin intervención.
  • GitHub Flavored Markdown completo: tablas, task lists, tachado, bloques de código con syntax highlighting.
  • Diagramas Mermaid: flowcharts, diagramas de secuencia, grafos de dependencias renderizan directamente.
  • Ecuaciones matemáticas con KaTeX: para documentación técnica o científica.
  • Command palette con búsqueda fuzzy: navegación rápida dentro de documentos largos.
  • Temas claro y oscuro.
  • Sanitización con DOMPurify: el HTML generado por el parser pasa por un filtro antes de renderizarse.

El punto de DOMPurify no es menor. Cuando el contenido lo genera un agente de IA, no siempre tenés control total de lo que escribe. Un agente podría, en teoría, producir Markdown que al renderizarse ejecute algo indeseado si el visor no sanitiza. (No es un vector de ataque común, pero zafa tenerlo en cuenta.) Más contexto en modelos como Claude Sonnet 4.6.

Tauri v2 como base significa que la aplicación compila a binario nativo en vez de empaquetar un Chromium completo como haría Electron. El consumo de memoria es considerablemente menor.

Instalación y workflow desde terminal

La instalación se hace vía el release oficial del repositorio o compilando desde el código fuente con el toolchain de Tauri (Rust + Node). Una vez instalado, el uso básico es:

  • marky ARCHIVO.md — abre un archivo específico con live reload.
  • marky CARPETA/ — modo workspace, lista todos los archivos Markdown de la carpeta.

¿Y qué pasa cuando tenés un agente escribiendo en un archivo mientras Marky lo tiene abierto? La vista se actualiza automáticamente. No necesitás recargar, no necesitás hacer nada. Es exactamente el comportamiento que querés cuando estás supervisando un agente en tiempo real.

Para equipos que usan pipelines de CI/CD que generan reportes en Markdown, el modo workspace es útil: abrís la carpeta de outputs y ves todos los archivos actualizarse a medida que el pipeline corre.

Marky vs otras herramientas markdown

La comparación honesta contra las alternativas más usadas:

HerramientaTipoCLI-firstLive reloadMermaidKaTeXPrecioPara agentes IA
MarkyApp nativa (Tauri)Gratis / open sourceDiseñado para esto
TyporaApp nativa (Electron)NoNo (WYSIWYG)USD 14,99 one-timeNo aplica
MarkViewExtensión ChromeNoNoParcialNoGratisLimitado
StackEditWebNoNoGratis / premiumNo aplica
VS Code PreviewPlugin en editorNoCon extensiónCon extensiónGratisRequiere abrir editor
visor markdown para agentes ia diagrama explicativo

Typora sigue siendo la mejor opción si escribís Markdown vos mismo, con un enfoque WYSIWYG que es bastante más cómodo para redacción. Para visualización de output automatizado, Marky tiene una ventaja clara: nadie más en esa lista está pensado específicamente para ese caso. Para más detalles técnicos, mirá en nuestra guía de LLMs grandes.

VS Code con live preview es la alternativa más cercana para desarrolladores que ya tienen el editor abierto. Pero si tu workflow es terminal-centric, abrir VS Code solo para ver un archivo que generó un agente es como usar una excavadora para plantar una maceta.

Casos de uso concretos en workflows de IA

Tres escenarios donde esto tiene sentido real:

Supervisión de agentes en tiempo real. Usás Claude Code o un agente similar para refactorizar un módulo grande. El agente genera un PROGRESS.md con los cambios que hizo y los que faltan. Con Marky abierto en otra pantalla, ves el progreso actualizado sin interrumpir al agente ni vos.

Documentación técnica generada automáticamente. Tenés un pipeline que corre tests, genera benchmarks y escribe un REPORT.md con los resultados, incluyendo un diagrama Mermaid de la arquitectura. Marky renderiza ese diagrama correctamente. Con un preview de GitHub raw o un cat en terminal, no.

Revisión de planes de desarrollo. Antes de ejecutar un plan generado por un agente, querés leerlo con formato, con las tablas bien renderizadas, con las listas de tareas con checkboxes. Marky te da eso en dos segundos desde la terminal, sin abrir nada más.

El contexto de AGENTS.md como estándar emergente también es relevante acá. Si los proyectos empiezan a incluir sistemáticamente archivos de instrucciones para agentes, tener un visor rápido para esos archivos deja de ser un nice-to-have.

Rendimiento y consideraciones técnicas

La elección de Tauri v2 sobre Electron no es cosmética. Una app Electron típica carga un proceso completo de Chromium: estamos hablando de 150-300 MB de RAM solo para el shell. Tauri usa el WebView nativo del sistema operativo (WKWebView en macOS), lo que baja ese número a 20-40 MB en la mayoría de los casos. Para una herramienta que vas a tener abierta mientras trabajás, la diferencia se nota en el tiempo. Sobre eso hablamos en ejecutar tus propios modelos localmente.

Eso sí: el ecosistema Tauri es más joven y tiene menos extensiones disponibles que Electron. Para una app como Marky, que hace una sola cosa, no importa. Pero si alguien quisiera extenderla, el camino es un poco más empinado que con una base Electron.

El parser markdown-it que usa Marky es uno de los más rápidos disponibles en JavaScript. Para archivos de documentación típicos (hasta 50.000 palabras, digamos), el renderizado es instantáneo. Para archivos muy grandes generados por agentes con mucha salida, no debería ser un cuello de botella.

Errores comunes al integrar visores Markdown en workflows de agentes

Error 1: Confiar en que el preview del editor alcanza. VS Code tiene preview de Markdown, sí. Pero si tu agente está corriendo y vos estás en la misma ventana del editor supervisando el código, alternar entre el editor y el preview constantemente rompe el foco. Una herramienta separada, en otra pantalla o ventana, es más limpia para supervisión.

Error 2: No sanitizar el contenido generado por IA. Si usás un viewer que renderiza HTML directamente sin sanitización, estás asumiendo que el agente siempre genera Markdown limpio. La mayoría de las veces es así, pero no siempre. Marky usa DOMPurify específicamente para este caso. Herramientas más viejas o simples no lo hacen.

Error 3: Abrir visores que no soportan Mermaid para documentación técnica. Los agentes de IA modernos generan diagramas Mermaid con frecuencia: flowcharts de arquitectura, diagramas de secuencia para APIs, grafos de dependencias. Si el visor no los renderiza, ves el código fuente del diagrama en vez del diagrama. No es útil para revisión rápida. Ya lo cubrimos antes en herramientas de generación IA.

Error 4: Ignorar el modo workspace para carpetas de outputs. Si el agente genera múltiples archivos en una carpeta, abrirlos uno por uno es ineficiente. El modo marky CARPETA/ lista todo y te permite navegar sin salir de la herramienta.

Preguntas Frecuentes

¿Qué es Marky y para qué sirve exactamente?

Marky es una aplicación de escritorio nativa para macOS, construida con Tauri v2, que visualiza archivos Markdown en tiempo real desde la terminal. Su uso principal es supervisar archivos generados por agentes de IA durante workflows de desarrollo automatizado, sin necesidad de abrir un editor completo.

¿Cómo instalo y uso Marky desde la terminal?

Descargás el binario desde el repositorio oficial o compilás desde el código fuente con Tauri y Node. Una vez instalado, el comando básico es marky ARCHIVO.md para un archivo específico, o marky CARPETA/ para el modo workspace que lista múltiples archivos Markdown.

¿Marky soporta diagramas Mermaid y ecuaciones matemáticas?

Sí. Marky incluye soporte nativo para diagramas Mermaid (flowcharts, secuencias, grafos) y ecuaciones matemáticas con KaTeX. Ambas funcionalidades están disponibles sin configuración adicional y renderizan dentro de la vista automáticamente.

¿Cuál es la mejor herramienta para visualizar markdown en tiempo real cuando trabajo con agentes de IA?

Para workflows CLI-first con agentes de IA, Marky es la opción más específica disponible en 2026: CLI-first, live reload, Mermaid, KaTeX y sanitización de HTML. Si ya tenés VS Code abierto y no necesitás una ventana separada, el preview integrado del editor alcanza para casos más simples.

¿Marky funciona en Windows o Linux?

Por ahora, Marky está diseñado para macOS. Tauri soporta Windows y Linux como targets de compilación, pero el soporte oficial del proyecto está en macOS. Para otros sistemas operativos, VS Code con la extensión de preview de Markdown o herramientas web como StackEdit son las alternativas más accesibles.

Conclusión

Marky resuelve un problema específico y lo resuelve bien: visualizar archivos Markdown generados por agentes de IA sin fricciones, desde la terminal, con actualización automática. No es una herramienta para escritores de documentación, no compite con Typora en comodidad de edición, y tampoco intenta ser un editor.

Lo que hace es exactamente lo que necesita cualquiera que trabaje con agentes de codificación de forma intensiva: un visor rápido, nativo, con soporte completo para Mermaid y KaTeX, que no consume 300 MB de RAM y que arranca con un comando. Para el desarrollador que supervisa un agente mientras trabaja, eso vale bastante más que mil funcionalidades que no va a usar.

El agentic coding como práctica se está consolidando en 2026. Herramientas como Marky, pequeñas y específicas, son parte del ecosistema de soporte que hace que ese workflow sea viable en el día a día. Sería interesante ver soporte oficial para Windows y Linux a medida que el proyecto madure.

Fuentes

Desplazarse hacia arriba