Wersja Markdown dla agentów nie działa

Krótka odpowiedź

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.

agent.markdown_broken · Priorytet: P2

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ć

  1. Otwórz adres URL z dowodów i sprawdź status, Content-Type i treść odpowiedzi.
  2. Jeśli kopii już nie ma, wdróż ją ponownie albo usuń tag <link rel="alternate" type="text/markdown"> i nagłówek Link, które na nią wskazują.
  3. Jeśli odpowiedź to HTML lub jest pusta, popraw konwersję tak, aby zwracała tekst strony jako Markdown z Content-Type: text/markdown.
  4. 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.

Sprawdź moją stronę →

Powiązane poradniki

Wszystkie znaleziska i jak działa wynik