Keine Markdown-Version für KI-Agenten

Kurze Antwort

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.

agent.no_markdown · Priorität: 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

  1. Wählen Sie einen Weg, Markdown auszuliefern: Beantworten Sie Accept: text/markdown unter der eigenen URL der Seite, oder veröffentlichen Sie eine Kopie wie /guide/index.md.
  2. 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 nach text/markdown fragt.
  3. Senden Sie Content-Type: text/markdown; charset=utf-8 und, wenn die URL dieselbe ist wie die der HTML-Seite, Vary: Accept.
  4. Verlinken Sie die Kopie im HTML-Head mit <link rel="alternate" type="text/markdown">, damit auch Agenten ohne Content Negotiation sie finden.
  5. 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.

Meine Seite prüfen →

Verwandte Anleitungen

Alle Befunde und wie der Score funktioniert