Sem versão em Markdown para agentes de IA
Quando a página foi solicitada com Accept: text/markdown, o servidor enviou HTML, e a página não aponta nenhuma cópia em Markdown. Os agentes de IA então leem todo o HTML, incluindo menus, rodapés e scripts. Servir uma versão em Markdown é opcional: é uma convenção recente, por isso a prioridade é P3.
O que significa
Quando solicitada com Accept: text/markdown, a página respondeu com HTML e não aponta nenhuma cópia em Markdown (<link rel="alternate" type="text/markdown">). Os agentes então leem todo o HTML, incluindo menus e scripts. Opcional: Markdown para agentes é uma convenção recente, não um padrão.
Por que isso importa para a busca com IA
Agentes que navegam por um usuário (e ferramentas que carregam páginas no contexto de um modelo) trabalham com texto, não com layout. Uma versão limpa em Markdown de uma página é várias vezes menor que o HTML e mantém os títulos, listas e links que importam. Algumas CDNs e frameworks já respondem a Accept: text/markdown com uma versão assim, e o llmstxt.org sugere uma cópia .md ao lado de cada página.
Nada quebra sem ela: os crawlers continuam lendo o HTML. É uma melhoria barata depois que os achados de acesso, robots.txt e conteúdo estiverem resolvidos.
Como corrigir
- Escolha uma forma de servir Markdown: responder a
Accept: text/markdownna própria URL da página ou publicar uma cópia como/guide/index.md. - Em uma CDN, ative a conversão para Markdown para agentes, se ela tiver. Em um framework, adicione um middleware que retorne a versão em Markdown quando o cabeçalho
Acceptpedirtext/markdown. - Envie
Content-Type: text/markdown; charset=utf-8e, quando a URL for a mesma da página HTML,Vary: Accept. - Vincule a cópia no head do HTML com
<link rel="alternate" type="text/markdown">, para que agentes que não negociam conteúdo também a encontrem. - Execute “Verificar de novo” no relatório da página para confirmar o resultado.
Exemplo
<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">
# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept Como confirmar a correção
Depois da mudança, clique em “Verificar de novo” no relatório: ele mostra o que foi corrigido e como a nota mudou.