Brak wersji Markdown dla agentów AI
Na żądanie strony z Accept: text/markdown serwer wysłał HTML, a strona nie wskazuje kopii w Markdown. Agenci AI czytają wtedy cały HTML, łącznie z menu, stopkami i skryptami. Wersja Markdown jest opcjonalna: to młoda konwencja, więc ma priorytet P3.
Co to oznacza
Na żądanie z Accept: text/markdown strona odpowiedziała kodem HTML i nie wskazuje kopii w Markdown (<link rel="alternate" type="text/markdown">). Agenci czytają wtedy cały HTML, łącznie z menu i skryptami. Opcjonalne: Markdown dla agentów to młoda konwencja, a nie standard.
Dlaczego to ważne dla wyszukiwarek AI
Agenci, którzy przeglądają strony w imieniu użytkownika (i narzędzia ładujące strony do kontekstu modelu), pracują z tekstem, a nie z układem. Czysta wersja Markdown jest kilka razy mniejsza od HTML i zachowuje ważne nagłówki, listy i linki. Niektóre CDN i frameworki już odpowiadają taką wersją na Accept: text/markdown, a llmstxt.org proponuje kopię .md obok każdej strony.
Bez niej nic się nie psuje: crawlery nadal czytają HTML. To tania poprawa, gdy dostęp, robots.txt i znaleziska dotyczące treści są już naprawione.
Jak to naprawić
- Wybierz jeden sposób udostępniania Markdown: odpowiadaj na
Accept: text/markdownpod adresem samej strony albo opublikuj kopię, na przykład/guide/index.md. - Jeśli Twój CDN ma konwersję do Markdown dla agentów, włącz ją. We frameworku dodaj middleware, który zwraca wersję Markdown, gdy nagłówek
Acceptprosi otext/markdown. - Wysyłaj
Content-Type: text/markdown; charset=utf-8, a gdy adres URL jest taki sam jak strony HTML, takżeVary: Accept. - Wskaż kopię w sekcji head HTML za pomocą
<link rel="alternate" type="text/markdown">, aby znaleźli ją również agenci, którzy nie negocjują formatu. - Uruchom „Sprawdź ponownie” w raporcie strony, aby potwierdzić wynik.
Przykład
<!-- 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 Jak potwierdzić poprawkę
Po zmianie kliknij „Sprawdź ponownie” w raporcie: zobaczysz, co zostało naprawione i jak zmienił się wynik.