¿Es el fin de Markdown?
Mike Codeur
Durante años, Markdown ha sido el formato natural para trabajar con IA. Es simple, legible, fácil de versionar, fácil de pegar en un prompt y perfecto para specs, notas, documentación ligera y contexto para agentes.
Pero una idea interesante llega desde el ecosistema de Claude Code en Anthropic: para ciertos outputs pensados para humanos, HTML puede ser más potente que Markdown.
La nuance importa. Markdown no está muerto. Pero no siempre es el mejor formato cuando el objetivo ya no es solo leer texto, sino entender, comparar, manipular o decidir.
Por qué Markdown ganó con la IA
Markdown funciona porque resuelve muchos problemas prácticos para los agentes:
- sigue siendo legible como texto plano;
- es fácil de versionar con Git;
- se copia y pega muy bien en prompts;
- funciona para specs, planes, resúmenes y notas;
- es ligero comparado con formatos más verbosos.
Para alimentar una IA con contexto, Markdown sigue siendo excelente. Si quieres darle a Claude Code una spec de producto, un README, un conjunto de reglas o un plan de trabajo, Markdown probablemente sigue siendo la mejor opción.
Dónde Markdown empieza a mostrar límites
El problema aparece cuando el agente ya no produce solo texto.
Cuando pides a una IA que te ayude a:
- comparar varias opciones;
- explorar una arquitectura;
- entender un flujo complejo;
- priorizar tareas;
- visualizar una review de código;
- tomar una decisión de producto;
- leer un informe con varios niveles de información.
En estos casos, un archivo Markdown largo puede volverse pesado. Haces scroll. Lees. Reconstruyes mentalmente la estructura. Y a veces abandonas antes de aprovechar realmente el resultado.
Por qué HTML se vuelve interesante
HTML permite al agente generar algo más que texto: una mini-interfaz.
No necesariamente una aplicación completa. Muchas veces solo un archivo temporal, abierto en el navegador, diseñado para entender o decidir más rápido.
Ejemplos concretos:
| Necesidad | Markdown | HTML |
|---|---|---|
| Comparar ideas | lista textual | tarjetas visuales lado a lado |
| Explorar un concepto | explicación lineal | diagrama interactivo |
| Priorizar tareas | tabla estática | columnas manipulables |
| Leer una review de código | bloques de texto | vista estructurada por archivo |
| Presentar un informe | documento largo | dashboard navegable |
No es solo una cuestión estética. El verdadero tema es la capacidad de decidir.
Una interfaz bien generada puede hacer que la información sea más clara, más manipulable y más accionable que un archivo Markdown de 200 líneas.
El buen modelo mental
La conclusión correcta no es "HTML reemplaza Markdown en todas partes".
La mejor distinción es:
Markdown para alimentar la IA. HTML para alimentar al humano.
Markdown sigue siendo excelente para inputs: contexto, specs, reglas, documentación, memoria y RAG.
HTML se vuelve interesante para ciertos outputs: dashboards, visualizaciones, exploraciones, informes interactivos, mini-herramientas y entregables temporales.
Por qué esto cambia los workflows agentic
Cuanto más producen los agentes IA, más importa el formato de salida.
Si el agente genera 100 líneas, Markdown basta.
Si genera un entregable que realmente tienes que usar, revisar, comparar o manipular, HTML puede ser mucho más adecuado.
Es un cambio importante en los workflows agentic: ya no pedimos solo a la IA que responda. A veces le pedimos que construya una interfaz desechable que nos ayude a pensar.
Ver el vídeo
Explico los casos precisos en los que HTML empieza a ocupar el lugar de Markdown en este vídeo: https://mkc.sh/html-markdown?utm_source=blog
Y si quieres recibir más ideas prácticas sobre Claude Code, agentes IA y workflows de desarrollo agentic, las comparto en The Agentic Dev: https://mkc.sh/the-agentic-dev?utm_source=blog