Die Markdown-Version für Agenten ist defekt

Kurze Antwort

Die Seite bietet Agenten eine Markdown-Version an, über eine Antwort auf Accept: text/markdown oder ein <link rel="alternate" type="text/markdown">, doch diese Version liefert einen Fehler, einen leeren Body oder eine HTML-Seite. Agenten, die danach fragen, bekommen nichts Brauchbares.

agent.markdown_broken · Priorität: P2

Was es bedeutet

Die Seite bietet Agenten Markdown an (als Antwort auf Accept: text/markdown oder als verlinkte Kopie), doch zurück kommt ein Fehler, ein leerer Body oder eine HTML-Seite.

Warum das für die KI-Suche wichtig ist

Ein Agent, der den Markdown-Link sieht oder eine text/markdown-Antwort erhält, vertraut ihr und greift womöglich nicht auf das HTML zurück. Eine defekte Kopie ist schlimmer als gar keine: Der Agent scheitert oder liest eine Fehlerseite als Ihren Inhalt.

Das passiert meist nach einem Umzug oder Neuaufbau: Die .md-Dateien wurden nicht deployt, eine Rewrite-Regel zeigt auf einen alten Pfad, oder eine Middleware kennzeichnet das HTML als text/markdown.

So beheben Sie es

  1. Öffnen Sie die URL aus den Belegen und sehen Sie sich Status, Content-Type und Body an.
  2. Ist die Kopie weg, deployen Sie sie erneut oder entfernen Sie das Tag <link rel="alternate" type="text/markdown"> und den Link-Header, die darauf verweisen.
  3. Ist die Antwort HTML oder leer, korrigieren Sie die Umwandlung so, dass sie den Seitentext als Markdown mit Content-Type: text/markdown liefert.
  4. Klicken Sie im Seitenbericht auf „Erneut prüfen“, um das Ergebnis zu bestätigen.

Beispiel

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

So bestätigen Sie den Fix

Klicken Sie nach der Änderung im Bericht auf „Erneut prüfen“: Er zeigt, was behoben wurde und wie sich der Score verändert hat.

Meine Seite prüfen →

Verwandte Anleitungen

Alle Befunde und wie der Score funktioniert