Ingeniero de Anthropic: el HTML es el mejor formato de salida de Claude Code, no Markdown

El equipo de ingenieros de Anthropic Claude Code, Thariq Shihipar, publicó el 8 de mayo “Using Claude Code: The Unreasonable Effectiveness of HTML”, donde sostiene que HTML debería reemplazar a Markdown como formato de salida para interactuar con Claude Code. Simon Willison resume los puntos clave: HTML ofrece gráficos con SVG, elementos interactivos, anclajes dentro de la página y estilos CSS, lo que permite que las respuestas de Claude pasen de “texto lineal” a “documentos multidimensionales”, mejorando de forma notable la eficiencia de lectura y comprensión. El tema ha generado muchísimo interés en la plataforma X: las dos publicaciones relacionadas de Shihipar suman más de 15.000 me gusta.

Punto central: HTML ofrece capacidades visuales e interactivas que Markdown no puede

Shihipar sostiene que HTML supera a Markdown por estas razones:

Riqueza visual: gráficos SVG, codificación por colores, y callouts con estilo

Interactividad: soporte nativo para widgets y componentes dinámicos

Navegación: anclajes dentro de la página y niveles jerárquicos de información estructurada

Maquetación profesional: estilos CSS que mejoran la claridad y la estética

Markdown se convirtió en estándar principalmente porque, en las primeras etapas, la context window de los LLM era relativamente pequeña (por ejemplo, en la era de GPT-4 de 8K), y los desarrolladores debían ahorrar tokens; las etiquetas de HTML consumen más tokens que Markdown y, en esa era de contextos pequeños, no era conveniente. Con la llegada de Claude a la era de contextos de entre 200K y 1M, el costo de tokens deja de ser una limitación, y la ventaja visual de HTML puede aprovecharse plenamente.

Aplicación concreta: al analizar vulnerabilidades de Linux, generar documentación técnica con tema oscuro en formato HTML

Shihipar usa como ejemplo el análisis de vulnerabilidades de seguridad en Linux:

Salida en Markdown: solo texto, apoyado en sangrías y niveles por títulos

Salida en HTML: documentación técnica con tema oscuro, con codificación por colores de la severidad, tablas comparativas lado a lado y bloques de advertencia

Experiencia del lector: la versión en HTML permite identificar de un vistazo la jerarquía del contenido técnico, el nivel de severidad y las relaciones de comparación

Con el mismo contenido de información, la legibilidad y la capacidad de acción de la salida en HTML superan con creces a la versión de texto plano en Markdown. Para escenarios que requieren generar “explicaciones para personas” (y no “texto plano para que lo lea una máquina”), HTML es una mejor opción.

Uso recomendado: exigir explícitamente en el prompt las capacidades completas de HTML + CSS + JS

Shihipar recomienda el siguiente patrón de prompt:

“Genera HTML; usa las capacidades completas de HTML, CSS y JavaScript para que la explicación sea rica, interactiva y clara”

Apto para: documentación técnica, explicaciones didácticas, visualización de datos e informes interactivos

No apto para: archivos de código puramente, y datos estructurados (aun usando el formato correspondiente)

Eventos concretos que se pueden seguir después: si Anthropic recomendará oficialmente a los usuarios de Claude Code las capacidades de salida en HTML, si otros marcos de IDE/Agentes (como Cursor, Codex) adoptarán formatos de salida similares, y cómo evolucionará a largo plazo la tasa de adopción de Markdown vs HTML en la comunidad de desarrolladores.

Este artículo de ingeniería de Anthropic: HTML es el mejor formato de salida para Claude Code, no Markdown, lo publicó por primera vez en cadena de noticias ABMedia.