Wersja Markdown dla agentów nie działa
Strona oferuje agentom wersję Markdown, w odpowiedzi na Accept: text/markdown lub przez <link rel="alternate" type="text/markdown">, ale ta wersja zwraca błąd, pustą treść albo stronę HTML. Agenci, którzy o nią proszą, nie dostają nic użytecznego.
Co to oznacza
Strona oferuje agentom Markdown (w odpowiedzi na Accept: text/markdown lub jako podlinkowaną kopię), ale zwraca błąd, pustą treść albo stronę HTML.
Dlaczego to ważne dla wyszukiwarek AI
Agent, który widzi link do Markdown albo dostaje odpowiedź text/markdown, ufa jej i może nie wrócić do HTML. Zepsuta kopia jest gorsza niż jej brak: agent albo zawodzi, albo czyta stronę błędu jako Twoją treść.
Zwykle dzieje się tak po przeprowadzce lub przebudowie: pliki .md nie zostały wdrożone, reguła przepisywania wskazuje starą ścieżkę albo middleware oznacza HTML jako text/markdown.
Jak to naprawić
- Otwórz adres URL z dowodów i sprawdź status,
Content-Typei treść odpowiedzi. - Jeśli kopii już nie ma, wdróż ją ponownie albo usuń tag
<link rel="alternate" type="text/markdown">i nagłówekLink, które na nią wskazują. - Jeśli odpowiedź to HTML lub jest pusta, popraw konwersję tak, aby zwracała tekst strony jako Markdown z
Content-Type: text/markdown. - Uruchom „Sprawdź ponownie” w raporcie strony, aby potwierdzić wynik.
Przykład
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 Jak potwierdzić poprawkę
Po zmianie kliknij „Sprawdź ponownie” w raporcie: zobaczysz, co zostało naprawione i jak zmienił się wynik.