De Markdown-versie voor agents werkt niet

Kort antwoord

De pagina biedt agents een Markdown-versie aan, via een antwoord op Accept: text/markdown of een <link rel="alternate" type="text/markdown">, maar die versie geeft een fout, een lege body of een HTML-pagina terug. Agents die erom vragen, krijgen niets bruikbaars.

agent.markdown_broken · Prioriteit: P2

Wat het betekent

De pagina biedt agents Markdown aan (als antwoord op Accept: text/markdown of als gelinkte kopie), maar wat terugkomt is een fout, een lege body of een HTML-pagina.

Waarom het ertoe doet voor AI-zoeken

Een agent die de Markdown-link ziet of een text/markdown-antwoord krijgt, vertrouwt daarop en valt misschien niet terug op de HTML. Een kapotte kopie is erger dan geen: de agent faalt, of leest een foutpagina als je content.

Dit gebeurt meestal na een verhuizing of een herbouw: de .md-bestanden zijn niet gedeployd, een rewrite-regel wijst naar een oud pad, of een middleware labelt de HTML als text/markdown.

Zo los je het op

  1. Open de URL uit het bewijs en bekijk de status, de Content-Type en de body.
  2. Is de kopie weg, deploy haar dan opnieuw of verwijder de <link rel="alternate" type="text/markdown">-tag en de Link-header die ernaar verwijzen.
  3. Is het antwoord HTML of leeg, herstel dan de conversie zodat ze de paginatekst als Markdown teruggeeft met Content-Type: text/markdown.
  4. Voer "Opnieuw controleren" uit in het paginarapport om het resultaat te bevestigen.

Voorbeeld

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

Hoe je de oplossing bevestigt

Klik na de wijziging op "Opnieuw controleren" in het rapport: het toont wat is opgelost en hoe de score is veranderd.

Controleer mijn pagina →

Gerelateerde gidsen

Alle bevindingen en hoe de score werkt