Docs

Soll ich KI-Agenten Markdown-Versionen meiner Seiten ausliefern (llms.txt, Markdown for Agents)?

Optional, und nie anstelle von gutem HTML. Google sagt, Sie brauchen kein Markdown und keine KI-Textdateien, um in der Google-Suche zu erscheinen, und seine KI-Funktionen lesen dieselben HTML-Seiten. Eine Markdown-Version hilft Agenten, die danach fragen, etwa Claude Code, Ihre Seite mit weniger Tokens zu lesen. Wenn Sie eine ergänzen, muss sie genau das sagen, was die HTML-Seite sagt.

Fakten

Wer liest die Markdown-Version überhaupt?

Vor allem Coding-Agenten und KI-Werkzeuge, die eine Seite auf Anfrage abrufen, nicht die Suchcrawler, die entscheiden, was zitiert wird.

LeserWas er liestHilft Markdown?
Google-Suche, Übersichten mit KI, KI-ModusIhre HTML-SeitenNein: Google sagt, dass es kein Markdown braucht
Coding-Agenten wie Claude CodeMarkdown, wenn die Website es bei Accept: text/markdown anbietetJa: weniger Tokens, saubererer Text
Leser von Entwickler-DokumentationenEine .md-Kopie jeder SeiteJa: Die Entwickler-Doku von OpenAI bietet eine an, wenn Sie .md an die URL anhängen
llms.txtEine kurze IndexdateiNicht für die Google-Suche, die sie ignoriert

Ist das Ausliefern von Markdown an Bots Cloaking?

Nicht, wenn der Inhalt gleich ist. Google definiert Cloaking als das Zeigen unterschiedlicher Inhalte für Nutzer und Suchmaschinen, mit der Absicht, Rankings zu manipulieren und Nutzer zu täuschen.

Eine Markdown-Kopie mit demselben Text, denselben Preisen und Aussagen wie die HTML-Seite ist ein anderes Format, nicht anderer Inhalt. Riskant ist eine Markdown-Seite mit zusätzlichen Aussagen, die nur für KI geschrieben sind.

Soll meine Unternehmenswebsite das tun oder nur Dokumentationsseiten?

Dokumentationen und Entwickler-Werkzeuge profitieren am meisten, weil ihre Leser oft Coding-Agenten sind. Eine Unternehmenswebsite, die an Menschen verkauft, hat mehr von vollständigen, serverseitig gerenderten HTML-Seiten, die die Fragen der Käufer beantworten.

Wenn Ihre Website bereits hinter Cloudflare auf einem bezahlten Tarif läuft, ist das Einschalten ein Schalter ohne Zusatzkosten. Eine zweite Kopie jeder Seite von Hand zu bauen und zu pflegen, lohnt sich selten.

Wie prüfe ich, was ein Agent erhält?

Rufen Sie die Seite mit dem Accept-Header für Markdown auf und lesen Sie die Header, die zurückkommen. Die Antwort muss content-type: text/markdown und vary: accept enthalten, damit Caches die beiden Versionen auseinanderhalten.

# Was ein Agent erhält, der Markdown anfordert
curl -s -H "Accept: text/markdown" https://www.example.com/pricing | head -20

# Die Header, die dabei zurückkommen müssen
curl -sI -H "Accept: text/markdown" https://www.example.com/pricing | grep -i -E "content-type|vary"
# erwartet: content-type: text/markdown ... und vary: accept

Wie geht easyIndex mit Markdown um?

easyIndex prüft jede Seite, wenn Ihr Coding-Agent sie einreicht, und danach die veröffentlichte HTML-Seite auf der Live-Website, weil diese die Such- und KI-Crawler lesen. Die Seite wird einmal geschrieben, für die Indexierung, deshalb gibt es keine zweite Version, die auseinanderlaufen kann.

Schritt für Schritt

  1. Zuerst das HTML reparieren. Stellen Sie sicher, dass jede öffentliche Seite ihren vollständigen Text im serverseitig gerenderten HTML hat und in der Sitemap steht.
  2. Entscheiden, wer Markdown braucht. Legen Sie eine Markdown-Version nur an, wenn Coding-Agenten oder Entwickler Ihre Seiten lesen, etwa bei Dokumentationen oder APIs.
  3. Eine Methode wählen. Schalten Sie Markdown for Agents bei Cloudflare ein oder lassen Sie Ihren Coding-Agenten bei Accept: text/markdown denselben Inhalt als Markdown ausliefern.
  4. Den Inhalt identisch halten. Erzeugen Sie das Markdown aus derselben Quelle wie das HTML, damit Preise und Aussagen nie abweichen.
  5. Mit curl testen. Rufen Sie eine Seite mit Accept: text/markdown auf und prüfen Sie, ob content-type und vary: accept zurückkommen.

Häufige Fehler

  • Markdown-Seiten mit Aussagen schreiben, die nicht auf der HTML-Seite stehen. Google nennt das Cloaking.
  • Markdown-Kopien bauen, während die HTML-Seiten ihren Text nur im Browser rendern.
  • Markdown unter derselben URL ausliefern, ohne vary: accept, sodass ein Cache Markdown an Browser gibt.
  • Erwarten, dass eine llms.txt-Datei oder Markdown-Kopien das Ranking in Google heben. Google sagt, dass es sie ignoriert.

So löst easyIndex das

Ihr Coding-Agent schreibt und veröffentlicht jede Seite in Ihrem Repository, angeleitet über MCP mit den aktuellen Regeln. easyIndex prüft sie bei der Einreichung, kontrolliert die HTML-Seite selbst auf der Live-Website und zeigt dann, welche Seiten KI-Crawler lesen und wie viele Besucher aus KI-Assistenten jede Seite bringt. 30 US$ pro Website und Monat, mit 7 Tagen kostenloser Testphase.

Häufig gestellte Fragen

Ist Markdown for Agents dasselbe wie llms.txt?

Nein. llms.txt ist eine einzige Indexdatei im Stammverzeichnis der Website. Markdown for Agents liefert eine Markdown-Version jeder Seite, wenn die Anfrage text/markdown verlangt.

Funktioniert Markdown for Agents im kostenlosen Tarif von Cloudflare?

Nein. Die Dokumentation von Cloudflare nennt die Tarife Pro, Business und Enterprise sowie SSL für SaaS-Kunden, ohne Aufpreis.

Zitiert mich ChatGPT öfter, wenn ich Markdown ausliefere?

Das hat niemand gezeigt. Die Crawler-Dokumentation von OpenAI sagt nichts über Markdown, und Zitate hängen davon ab, dass die Seite gecrawlt werden kann und die Frage beantwortet.

Kann mein Coding-Agent das ohne Cloudflare bauen?

Ja. Eine Route oder Middleware kann denselben Inhalt als Markdown liefern, wenn der Accept-Header danach fragt, mit vary: accept in der Antwort.

Weiterlesen

Zuletzt geprüft am .

Markdown für KI-Agenten: llms.txt oder Markdown for Agents?