Brak wersji Markdown dla agentów AI

Krótka odpowiedź

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.

agent.no_markdown · 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ć

  1. Wybierz jeden sposób udostępniania Markdown: odpowiadaj na Accept: text/markdown pod adresem samej strony albo opublikuj kopię, na przykład /guide/index.md.
  2. 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 Accept prosi o text/markdown.
  3. Wysyłaj Content-Type: text/markdown; charset=utf-8, a gdy adres URL jest taki sam jak strony HTML, także Vary: Accept.
  4. 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.
  5. 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.

Sprawdź moją stronę →

Powiązane poradniki

Wszystkie znaleziska i jak działa wynik