HTML y Markdown para agentes: guía práctica

Compara HTML, Markdown for Agents, llms.txt y las fichas de capacidades, y decide qué representación necesita realmente tu sitio web.

Una página HTML y una versión Markdown se derivan del mismo contenido y conducen a capacidades documentadas del sitio.
Por Publicado Actualizado

HTML debe seguir siendo la representación accesible principal del sitio. Markdown puede servir como alternativa para clientes compatibles; llms.txt es una propuesta comunitaria de descubrimiento, no un requisito de Google ni una garantía de visibilidad en IA.

La pregunta no es si debemos sustituir toda una web por texto plano. Es si hay consumidores concretos que necesitan otra representación y cómo mantenerla alineada con la página canónica.

Cuatro piezas distintas

RecursoFunciónLímite
HTMLPresenta páginas semánticas a navegadores y personasNo concede permiso para una transacción
MarkdownOfrece texto estructurado a clientes que lo admitenNo tiene ventaja SEO universal confirmada
llms.txtPropone un índice curado de recursos para modelos de lenguajeNo es una norma oficial ni una señal de ranking confirmada
Agent Card o Server CardDescribe capacidades de agentes o servidores según protocolos concretosNo es un formato para publicar el contenido del sitio

Google afirma que sus funciones de IA usan las prácticas generales de Search, sin exigir archivos especiales. Revisa su guía sobre funciones de IA.

Markdown for Agents

Cloudflare ofrece Markdown for Agents: un cliente puede solicitar una representación Markdown mediante Accept: text/markdown, y la plataforma convierte la página en el edge. Consulta la documentación de Cloudflare para estado, configuración y requisitos.

Es una opción, no un requisito. Compara HTML y Markdown para asegurarte de que tablas, enlaces, condiciones, precios y avisos importantes no desaparecen. Revisa también caché, fechas de actualización y contenido cargado dinámicamente. No asumas que todos los agentes solicitan Markdown.

¿Qué es llms.txt?

La comunidad describe en llmstxt.org una propuesta de archivo en la raíz del sitio con una selección de enlaces y contexto. Puede ser un índice complementario si se mantiene actualizado, pero no sustituye al sitemap, a robots.txt ni a las páginas públicas.

Google indica en sus actualizaciones de Search que llms.txt no afecta la visibilidad en Google Search. Por tanto, no lo presentes como un factor de ranking ni como garantía de cita.

Tarjetas de capacidades no son índices editoriales

A2A utiliza Agent Cards para describir capacidades de un agente. MCP Server Card es una iniciativa distinta para el descubrimiento de servidores MCP y su diseño sigue evolucionando. La documentación de A2A de Google Cloud explica el uso de la Agent Card. Estas tarjetas anuncian servicios; llms.txt organiza enlaces a contenido.

La guía de AWO publicada explica la preparación de una web en sentido amplio. No hace falta introducir un archivo nuevo en cada sitio: primero identifica quién lo consumirá y para qué.

Una arquitectura sencilla

  1. Conserva HTML como fuente canónica, accesible y completa.
  2. Añade Markdown solo si un cliente o integración lo necesita.
  3. Comprueba que ambas versiones representan los mismos datos.
  4. Publica llms.txt solo si mantendrás su índice; mide acceso, no supuesta influencia en rankings.
  5. Documenta APIs y herramientas en su propia capa de capacidades.

Por ejemplo, una empresa SaaS puede ofrecer páginas HTML para personas y Markdown para un cliente técnico. Los límites de plan y condiciones deben coincidir. Si una versión se queda obsoleta, crea confusión para todos los consumidores.

Preguntas frecuentes

¿Necesito llms.txt para aparecer en Google o ChatGPT?

No hay garantía de inclusión o cita por publicarlo. Google afirma que no afecta a Search; el comportamiento de otros servicios debe comprobarse por separado.

¿Markdown reemplaza mi web?

No como regla general. Es una posible representación secundaria. Mantén la experiencia HTML accesible.

¿Una Agent Card es lo mismo que llms.txt?

No. Una describe capacidades de un agente; el otro es una propuesta de índice de contenido.

Decide con evidencia de uso

Antes de habilitar formatos, identifica el cliente y la necesidad. Si una alternativa reduce fricción y se mantiene coherente, puede tener utilidad. Si solo duplica contenido sin consumidor identificado, fortalece primero las páginas HTML.

La capa de visibilidad tradicional también importa; consulta la comparación de SEO, AEO y GEO para separar el trabajo editorial del formato de entrega.

¿Quieres llevar esta idea a tu negocio?

Explora los servicios y encuentra el siguiente paso concreto.

Ver servicios

Reserva online

Elige el horario que mejor te encaje