¿Qué es el Markdown para agentes?

Markdown es una sintaxis para escribir texto con formato usando signos sencillos: almohadillas para los títulos, asteriscos para la negrita. «Markdown para agentes» no habla de escribir así, sino de servir cada página de tu web también en ese formato, para que un agente de IA la lea sin el menú, los scripts ni la maquetación. No es el llms.txt, que es un índice del sitio, ni el agents.md de Shopify, que describe la tienda: es una versión limpia de cada página. Te importa porque una ficha de producto en HTML lleva mucho más código que contenido, y los agentes que leen la web ya piden esta versión.

Qué es estándar y qué no

Bajo el mismo nombre conviven tres piezas de origen muy distinto, y conviene separarlas antes de decidir nada.

La negociación de contenido, que es estándar. HTTP prevé que una misma dirección pueda tener varias representaciones del mismo recurso. La negociación de contenido funciona así: el cliente dice qué prefiere con las cabeceras Accept, y el servidor elige la representación según esas preferencias. La cabecera Vary de la respuesta indica qué cabeceras de la petición tuvo en cuenta para elegir.⁠^{[1]IETF (Fielding, Nottingham y Reschke). RFC 9110: HTTP Semantics} El tipo text/markdown existe como tipo registrado desde marzo de 2016: el RFC 7763 lo describe como una familia de sintaxis de texto plano que pueden convertirse a HTML, y exige declarar el juego de caracteres con el parámetro charset.⁠^{[2]IETF (S. Leonard). RFC 7763: The text/markdown Media Type} Con estas dos piezas, un agente puede pedir Accept: text/markdown en la misma URL de tu ficha y recibir Markdown.

Las URL terminadas en .md, que son una propuesta. La propuesta de llms.txt sugiere que las páginas que un agente pueda necesitar tengan una versión limpia en Markdown en la misma URL, con .md añadido al final (pagina.html.md) o sustituyendo la extensión (pagina.md); las URL sin nombre de archivo añaden index.html.md o index.md. Para que un cliente las encuentre, recomienda enlazarlas con rel="alternate" type="text/markdown", en el HTML o en una cabecera Link de HTTP.⁠^{[3]llmstxt.org (Jeremy Howard). The /llms.txt file, v2} Es una convención con autor y con fecha, no un estándar de ningún organismo.

La conversión automática, que es una función de un proveedor. El 12 de febrero de 2026, Cloudflare presentó Markdown for Agents, en beta.⁠^{[4]Cloudflare Blog (Celso Martinho y Will Allen). Introducing Markdown for Agents} Si lo activas en tu zona, cuando una petición llega con Accept: text/markdown, Cloudflare pide el HTML a tu servidor, lo convierte a Markdown y lo entrega. Está disponible sin coste en los planes Pro, Business y Enterprise, solo convierte HTML y no convierte respuestas de más de 2 MB. La respuesta lleva Content-Type: text/markdown; charset=utf-8, un Vary que incluye Accept para que la caché guarde las dos versiones por separado, una estimación de tokens en x-markdown-tokens, y pierde las cabeceras ETag y Last-Modified.⁠^{[5]Cloudflare Docs. Markdown for Agents}

El argumento a favor es el tamaño. Cloudflare midió su propio artículo de presentación: 16.180 tokens en HTML y 3.150 en Markdown, un 80 % menos. Y contó que agentes de programación muy usados, como Claude Code y OpenCode, ya envían esa cabecera al pedir una página.⁠^{[4]Cloudflare Blog (Celso Martinho y Will Allen). Introducing Markdown for Agents} Menos texto sobrante deja más sitio en la ventana de contexto del modelo para lo que importa.

Lo que dice Google

Para la Búsqueda de Google, la respuesta es corta: no hace falta crear archivos legibles por máquinas, archivos de texto para IA, marcado ni Markdown para aparecer en la Búsqueda, incluidas sus funciones de IA generativa, porque la Búsqueda no los usa.⁠^{[6]Google Search Central. Optimizing your website for generative AI features on Google Search} El Markdown para agentes es para los otros lectores: los asistentes y agentes que piden páginas para responder o para actuar.

Hay una línea que no conviene cruzar. Google define el cloaking como presentar contenido distinto a los usuarios y a los buscadores con la intención de manipular las posiciones y engañar a los usuarios, y pone como ejemplo insertar texto o palabras clave solo cuando quien pide la página es un buscador.⁠^{[7]Google Search Central. Spam policies for Google web search} Una versión en Markdown que dice lo mismo que la página no es eso. Una que añade argumentos, precios o promesas que la página no tiene, sí se le parece.

En una tienda

Un ejemplo ficticio: la ficha de un trípode, pedida por un agente con negociación de contenido.

curl -s -D - -H "Accept: text/markdown" https://tripodes-ejemplo.com/products/tripode-viaje

HTTP/2 200
content-type: text/markdown; charset=utf-8
vary: Accept

# Trípode de viaje de carbono

Trípode plegable para cámaras sin espejo, con rótula de bola.

- Precio: 189,00 EUR
- Disponibilidad: en stock

## Preguntas frecuentes

### ¿Cabe en el equipaje de mano?
Sí, plegado mide menos que una mochila de cabina estándar.

Lo que importa no es el formato sino lo que trae: el nombre, el precio, la disponibilidad y las respuestas a las dudas del comprador, sin el menú, el pie de página ni el carrito. Ese texto tiene que coincidir con la ficha en HTML; si el precio cambia en una, cambia en la otra. Clione genera un documento en Markdown por producto, con su nombre, sus detalles, una guía de compra, sus palabras clave y sus preguntas frecuentes, y lo sirve en el propio dominio de la tienda.

Cómo comprobarlo

1. Pide una ficha con la cabecera Accept: text/markdown, con curl como en el ejemplo, y mira el Content-Type de la respuesta. Si vuelve text/html, tu sitio no negocia el formato.⁠^{[1]IETF (Fielding, Nottingham y Reschke). RFC 9110: HTTP Semantics}
2. Prueba la convención de la propuesta: la misma URL con .md al final. Un 404 solo dice que no la usas.⁠^{[3]llmstxt.org (Jeremy Howard). The /llms.txt file, v2}
3. Busca en el HTML de la ficha un <link rel="alternate" type="text/markdown"> o en las cabeceras de la respuesta un Link con ese tipo: es como un agente sabe que existe la versión limpia.⁠^{[3]llmstxt.org (Jeremy Howard). The /llms.txt file, v2}
4. Si la versión existe, compárala con la página: precio, disponibilidad y textos tienen que coincidir.⁠^{[7]Google Search Central. Spam policies for Google web search}
5. Si usas Cloudflare, comprueba la cabecera Vary (tiene que incluir Accept) y la cabecera content-signal, y decide si la señal por defecto es la que quieres.⁠^{[5]Cloudflare Docs. Markdown for Agents}

Concepto cercano: llms.txt

El llms.txt y el Markdown para agentes vienen de la misma propuesta, pero hacen trabajos distintos. El llms.txt es un único archivo que resume el sitio y enlaza sus páginas; las versiones en Markdown son esas páginas, una por una, en limpio. La propuesta los une: el llms.txt debería enlazar versiones legibles por un modelo, y cada versión en Markdown puede apuntar al llms.txt que la cubre con rel="describedby".⁠^{[3]llmstxt.org (Jeremy Howard). The /llms.txt file, v2} Uno es el índice; el otro, el contenido.

Para seguir, la entrada de negociación de contenido explica el mecanismo de HTTP con más detalle, y la ruta de lectura de este tema ordena el resto de términos.