Docs

¿Debo servir versiones en Markdown de mis páginas a los agentes de IA (llms.txt, Markdown for Agents)?

Es opcional y nunca reemplaza un buen HTML. Google dice que no necesitas Markdown ni archivos de texto para IA para aparecer en la Búsqueda, y sus funciones de IA leen las mismas páginas HTML. Una versión en Markdown ayuda a los agentes que la piden, como Claude Code, a leer tu página con menos tokens. Si la agregas, debe decir exactamente lo mismo que el HTML.

Datos

¿Quién lee de verdad la versión en Markdown?

Sobre todo agentes de código y herramientas de IA que traen una página a pedido, no los rastreadores de búsqueda que deciden qué se cita.

Quién leeQué lee¿Ayuda el Markdown?
Búsqueda de Google, AI Overviews, Modo IATus páginas HTMLNo: Google dice que no necesita Markdown
Agentes de código como Claude CodeMarkdown cuando el sitio lo ofrece con Accept: text/markdownSí: menos tokens, texto más limpio
Lectores de documentación técnicaUna copia .md de cada páginaSí: la propia documentación para desarrolladores de OpenAI la ofrece al agregar .md a la URL
llms.txtUn archivo corto de índiceNo para la Búsqueda de Google, que lo ignora

¿Servir Markdown a los bots es cloaking?

No, si el contenido es el mismo. Google define el cloaking como mostrar contenido distinto a usuarios y buscadores con la intención de manipular el posicionamiento y engañar a los usuarios.

Una copia en Markdown con el mismo texto, los mismos precios y las mismas afirmaciones del HTML es otro formato, no otro contenido. El riesgo es una página en Markdown con afirmaciones extra escritas solo para la IA.

¿Mi sitio de empresa lo necesita o solo los sitios de documentación?

La documentación y las herramientas para desarrolladores ganan más, porque quien las lee suele ser un agente de código. Un sitio que vende a personas gana más con páginas HTML completas, renderizadas en el servidor, que responden las preguntas del comprador.

Si tu sitio ya está detrás de Cloudflare en un plan de pago, activar la función es un interruptor y no cuesta nada extra. Armar y mantener a mano una segunda copia de cada página rara vez vale la pena.

¿Cómo reviso lo que recibe un agente?

Pide la página con el encabezado Accept de Markdown y lee los encabezados de la respuesta. Debe traer content-type: text/markdown y vary: accept, para que la caché no mezcle las dos versiones.

# What an agent that asks for Markdown receives
curl -s -H "Accept: text/markdown" https://www.example.com/pricing | head -20

# The headers that must come back with it
curl -sI -H "Accept: text/markdown" https://www.example.com/pricing | grep -i -E "content-type|vary"
# expected: content-type: text/markdown ... and vary: accept

¿Cómo trata easyIndex el Markdown?

easyIndex audita cada página cuando tu agente de código la envía, y luego revisa la página HTML publicada en el sitio en vivo, porque eso es lo que leen los rastreadores de búsqueda y de IA. La página se escribe una vez, para indexación, así que no hay una segunda versión que se desfase.

Paso a paso

  1. Arregla el HTML primero. Asegúrate de que cada página pública tenga su texto completo en el HTML renderizado en el servidor y esté en el sitemap.
  2. Decide quién necesita Markdown. Agrega una versión en Markdown solo si agentes de código o desarrolladores leen tus páginas, como en documentación o APIs.
  3. Elige un solo método. Activa Markdown for Agents de Cloudflare, o pídele a tu agente de código que sirva el mismo contenido en Markdown con Accept: text/markdown.
  4. Mantén el contenido idéntico. Genera el Markdown desde la misma fuente que el HTML para que precios y afirmaciones nunca difieran.
  5. Prueba con curl. Pide una página con Accept: text/markdown y confirma que vuelven content-type y vary: accept.

Errores comunes

  • Escribir páginas en Markdown con afirmaciones que no están en el HTML, lo que Google llama cloaking.
  • Crear copias en Markdown mientras las páginas HTML todavía arman su texto solo en el navegador.
  • Servir Markdown en la misma URL sin vary: accept, y que la caché entregue Markdown a los navegadores.
  • Esperar que un llms.txt o copias en Markdown mejoren el posicionamiento en Google, que dice ignorarlos.

Cómo lo resuelve easyIndex

Tu agente de código escribe y publica cada página en tu repositorio, guiado por MCP con las reglas actuales; easyIndex la audita al recibirla, revisa por sí mismo la página HTML publicada y luego muestra qué páginas leyeron los rastreadores de IA y cuántos visitantes de asistentes de IA trajo cada una. US$ 30 por sitio al mes, con 7 días gratis.

Preguntas frecuentes

¿Markdown for Agents es lo mismo que llms.txt?

No. llms.txt es un archivo de índice en la raíz del sitio; Markdown for Agents devuelve una versión en Markdown de cualquier página cuando la solicitud acepta text/markdown.

¿Markdown for Agents funciona en el plan gratuito de Cloudflare?

No. La documentación de Cloudflare lista los planes Pro, Business y Enterprise y a los clientes de SSL for SaaS, sin costo extra.

¿ChatGPT citará más mi sitio si sirvo Markdown?

Nadie lo ha demostrado. La documentación de los rastreadores de OpenAI no habla de Markdown, y la cita depende de que la página sea rastreable y responda la pregunta.

¿Mi agente de código puede hacerlo sin Cloudflare?

Sí. Una ruta o un middleware puede devolver el mismo contenido en Markdown cuando el encabezado Accept lo pide, con vary: accept en la respuesta.

Sigue leyendo

Verificado el .

¿Servir Markdown a agentes de IA? llms.txt y Cloudflare