A versão em Markdown para agentes está quebrada

Resposta rápida

A página oferece uma versão em Markdown aos agentes, por meio de uma resposta a Accept: text/markdown ou de um <link rel="alternate" type="text/markdown">, mas essa versão retorna um erro, um corpo vazio ou uma página HTML. Os agentes que a pedem não recebem nada útil.

agent.markdown_broken · Prioridade: P2

O que significa

A página oferece Markdown aos agentes (como resposta a Accept: text/markdown ou como cópia vinculada), mas o que volta é um erro, um corpo vazio ou uma página HTML.

Por que isso importa para a busca com IA

Um agente que vê o link para o Markdown ou recebe uma resposta text/markdown confia nela e pode não voltar ao HTML. Uma cópia quebrada é pior que nenhuma: o agente falha ou lê uma página de erro como se fosse o seu conteúdo.

Isso costuma acontecer depois de uma migração ou de uma reconstrução do site: os arquivos .md não foram publicados, uma regra de rewrite aponta para um caminho antigo ou um middleware marca o HTML como text/markdown.

Como corrigir

  1. Abra a URL das evidências e confira o status, o Content-Type e o corpo.
  2. Se a cópia sumiu, publique-a de novo ou remova a tag <link rel="alternate" type="text/markdown"> e o cabeçalho Link que apontam para ela.
  3. Se a resposta for HTML ou estiver vazia, corrija a conversão para que ela retorne o texto da página em Markdown com Content-Type: text/markdown.
  4. Execute “Verificar de novo” no relatório da página para confirmar o resultado.

Exemplo

curl -sS -H 'Accept: text/markdown' -D - -o /dev/null https://example.com/guide/
# expect: HTTP/2 200, 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.

Verificar minha página →

Guias relacionados

Todos os achados e como a nota funciona