En cuanto empiezas a usar un agente de IA como Claude Code o Codex, tu ordenador se llena de archivos «.md»: el CLAUDE.md donde escribes las instrucciones para el agente, y los resultados de investigaciones y planes de trabajo que el agente redacta para ti. Todos son archivos de texto escritos en un formato llamado Markdown.
Pero, al hacer doble clic en un archivo .md, a menudo no se abre de forma legible. En este artículo te presentamos Markdocx, una app para Mac y Windows para leer y editar archivos .md, pensada para quienes usan agentes de IA.
Los agentes de IA trabajan con archivos .md
Cuando trabajas con un agente de IA, los archivos .md sirven para dos cosas: las instrucciones y los resultados.
Instrucciones para el agente
Claude Code lee CLAUDE.md cada vez que empieza a trabajar. Si anotas ahí tu forma de trabajar, las reglas que quieres que siga y cómo te gusta que se escriba, no tendrás que explicarlo cada vez.
| Archivo | Lo lee | Para qué sirve |
|---|---|---|
| CLAUDE.md en la carpeta del proyecto | Claude Code | Instrucciones para ese proyecto. Con el comando /init puedes crear una primera versión |
| ~/.claude/CLAUDE.md | Claude Code | Tus preferencias, para todos los proyectos |
| AGENTS.md | Codex (Claude Code también puede leerlo) | Instrucciones para el proyecto |
~/.claude es una carpeta oculta dentro de tu carpeta de inicio. En el Finder del Mac, pulsa Command + Shift + . (punto) para mostrar las carpetas ocultas.
Las instrucciones no se escriben una vez y ya está. Las vuelves a leer mientras ves cómo trabaja el agente, añades cosas y las haces crecer.
Lo que te entrega el agente
Informes de investigación, planes de trabajo, resúmenes de cambios, archivos README: lo que te devuelve un agente también suele llegar en archivos .md. Markdown marca los títulos, las listas y las tablas con símbolos, así que a una IA le resulta fácil escribirlo y a las personas, seguir su estructura. Cuando el agente explica un proceso o cómo está organizado algo, a menudo añade un diagrama escrito en un formato llamado Mermaid.
Pero los archivos .md cuestan de leer
Un archivo .md es texto en el que los títulos se marcan con «#», la negrita con «**» y las tablas con «|». Y, sorprendentemente, hay pocas apps que lo pongan en limpio cuando haces doble clic.
- En el Mac, se abre en una app como TextEdit con los símbolos a la vista, o se abre una app para desarrolladores
- El Bloc de notas de Windows 11 ya puede mostrar formatos sencillos como títulos, negrita y listas. Pero las tablas, el código coloreado y los diagramas Mermaid, tan habituales en lo que entrega un agente, quedan fuera de lo que muestra
Para leerlos bien hay que pegarlos en un servicio web o abrir una previsualización en un editor para desarrolladores: un paso más. Hacerlo cada vez que el agente te entrega un informe acaba cansando. Y, cuando editas CLAUDE.md, te toca reescribir un texto lleno de símbolos.
Con Markdocx, lo lees con un doble clic y lo editas ahí mismo
Markdocx es una app para Mac y Windows que muestra un archivo .md como un documento limpio en cuanto lo abres. Si haces que Markdocx sea la app para los archivos .md, a partir de entonces basta con un doble clic. Los pasos se explican en nuestro artículo sobre una app para abrir archivos .md.
Lee lo que te entrega el agente como un documento limpio
- Los títulos, las listas, las tablas, las listas de tareas y las citas se muestran bien maquetados, con el código coloreado según el lenguaje
- Los diagramas Mermaid aparecen como diagramas. Admite 10 tipos, desde diagramas de flujo hasta diagramas de secuencia, y se dibujan en tu ordenador, así que puedes verlos sin conexión a internet
- Los títulos aparecen en el esquema de la izquierda, así que puedes saltar a cualquier parte de un informe largo
Edita CLAUDE.md mientras ves la previsualización
- Coloca el editor y la previsualización uno al lado del otro. Lo que escribes aparece enseguida en la previsualización, así que puedes comprobar cómo quedan organizadas tus instrucciones bajo cada título mientras añades más
- La barra de formato inserta negrita, enlaces, tablas, listas y más, sin necesidad de recordar toda la sintaxis de Markdown
- Lo que escribes se guarda automáticamente, y un archivo .md sigue siendo un archivo .md. El agente leerá tu CLAUDE.md o AGENTS.md editado la próxima vez que empiece a trabajar
Entrega los resultados en Word o PDF
A veces quieres pasar un informe del agente a compañeros o clientes que no usan IA. Con Markdocx, lo exportas a Word (.docx) o PDF desde el botón de exportar de la barra de herramientas. Los títulos, las tablas y el código pasan tal cual, y los diagramas Mermaid entran como imágenes, así que quien lo reciba puede verlos solo con Word. Más detalles en nuestro artículo sobre Mermaid y la exportación a Word.
Leer y editar es gratis para siempre
Markdocx está disponible en el Mac App Store y en Microsoft Store. Todas las funciones son gratis durante los primeros 14 días. Después, abrir, leer y editar archivos .md sigue siendo gratis sin límite de tiempo. No hace falta crear una cuenta. La exportación a Word, PDF y otros formatos se desbloquea con una compra única. No es una suscripción.
La versión para Mac funciona en macOS 26 o posterior, y la versión para Windows en Windows 11 y Windows 10 (versión 1809 o posterior).
