De Markdown-versie voor agents werkt niet
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.
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
- Open de URL uit het bewijs en bekijk de status, de
Content-Typeen de body. - Is de kopie weg, deploy haar dan opnieuw of verwijder de
<link rel="alternate" type="text/markdown">-tag en deLink-header die ernaar verwijzen. - Is het antwoord HTML of leeg, herstel dan de conversie zodat ze de paginatekst als Markdown teruggeeft met
Content-Type: text/markdown. - 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.