Keine Markdown-Version für KI-Agenten
Auf eine Anfrage mit Accept: text/markdown schickte der Server HTML, und die Seite verlinkt keine Markdown-Kopie. KI-Agenten lesen dann das gesamte HTML, samt Menüs, Footern und Skripten. Eine Markdown-Version anzubieten ist optional: Es ist eine junge Konvention, daher P3.
Was es bedeutet
Auf eine Anfrage mit Accept: text/markdown antwortete die Seite mit HTML, und sie verlinkt keine Markdown-Kopie (<link rel="alternate" type="text/markdown">). Agenten lesen dann das gesamte HTML, samt Menüs und Skripten. Optional: Markdown für Agenten ist eine junge Konvention, kein Standard.
Warum das für die KI-Suche wichtig ist
Agenten, die für einen Nutzer surfen (und Tools, die Seiten in den Kontext eines Modells laden), arbeiten mit Text, nicht mit Layout. Eine saubere Markdown-Version einer Seite ist um ein Mehrfaches kleiner als ihr HTML und behält die Überschriften, Listen und Links, auf die es ankommt. Manche CDNs und Frameworks beantworten Accept: text/markdown bereits mit einer solchen Version, und llmstxt.org schlägt neben jeder Seite eine .md-Kopie vor.
Ohne sie geht nichts kaputt: Crawler lesen weiterhin das HTML. Es ist eine günstige Verbesserung, sobald die Befunde zu Zugriff, robots.txt und Inhalt behoben sind.
So beheben Sie es
- Wählen Sie einen Weg, Markdown auszuliefern: Beantworten Sie
Accept: text/markdownunter der eigenen URL der Seite, oder veröffentlichen Sie eine Kopie wie/guide/index.md. - Auf einem CDN schalten Sie dessen Markdown-Umwandlung für Agenten ein, falls es eine hat. In einem Framework fügen Sie eine Middleware hinzu, die die Markdown-Version zurückgibt, wenn der
Accept-Header nachtext/markdownfragt. - Senden Sie
Content-Type: text/markdown; charset=utf-8und, wenn die URL dieselbe ist wie die der HTML-Seite,Vary: Accept. - Verlinken Sie die Kopie im HTML-Head mit
<link rel="alternate" type="text/markdown">, damit auch Agenten ohne Content Negotiation sie finden. - Klicken Sie im Seitenbericht auf „Erneut prüfen“, um das Ergebnis zu bestätigen.
Beispiel
<!-- 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 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.