Markdown for Agents

Wer einem KI-Agenten eine Webseite zum Lesen gibt, bezahlt für alles mit, was ein Mensch kaum bewusst wahrnimmt: Navigation, Cookie-Hinweise, Skripte, verschachtelte Container mit langen Klassennamen. Für das Sprachmodell ist das Ballast, der Platz im Kontextfenster belegt, Rechenzeit kostet und den eigentlichen Text verwässert.

Markdown for Agents setzt genau dort an. Fragt ein Agent eine Seite mit dem Hinweis an, dass er Markdown bevorzugt, bekommt er statt HTML eine schlanke Textfassung mit Überschriften, Listen und Links. Unter dem Namen hat Cloudflare im Februar 2026 eine konkrete Funktion seines Netzwerks eingeführt; im weiteren Sinn steht der Begriff für alle Wege, Agenten Markdown-Fassungen von Webseiten anzubieten, verwandt mit der Idee hinter llms.txt. Gemessen wird der Effekt in Token.

So funktioniert die Cloudflare-Funktion

Technische Grundlage ist die HTTP-Inhaltsverhandlung, ein seit Jahrzehnten genutztes Verfahren: Der Client schreibt in den Header Accept, welche Formate er versteht. Browser fragen nach text/html. Ein Agent, der text/markdown als Option angibt, erhält bei aktivierter Funktion eine Markdown-Fassung. Cloudflare holt dafür das HTML wie gewohnt vom Server der Website und wandelt es am Netzwerkrand um. Die URL bleibt dieselbe, Menschen sehen keine Änderung.

curl https://www.beispiel-shop.de/ratgeber/ \
-H "Accept: text/markdown"

Laut Dokumentation (Stand 9. Oktober 2026) hat die Antwort einen festen Aufbau:

• Kopfbereich im YAML-Format mit Titel, Beschreibung und Bild aus den Meta-Angaben der Seite, sofern vorhanden.
• Haupttext als Markdown. Kopfzeile, Fußzeile, Navigation, Skripte und Styles entfernt Cloudflare vor der Umwandlung.
• Strukturierte Daten im JSON-LD-Format bleiben als Codeblock am Ende erhalten.
• Zusätzliche Header: x-markdown-tokens schätzt die Token-Zahl, Vary: Accept sorgt dafür, dass Caches HTML und Markdown getrennt speichern.

Eingeschaltet wird die Funktion im Cloudflare-Dashboard im Bereich AI Crawl Control, per API oder über eine Konfigurationsregel nur für bestimmte Subdomains oder Pfade. Sie steht ohne Aufpreis in den Tarifen Pro, Business und Enterprise sowie für SSL-for-SaaS-Kunden zur Verfügung. Umgewandelt wird nur HTML bis 6 MiB, andere Dokumenttypen nicht.

Was es spart und wer es nutzt

Cloudflare rechnet den Effekt am eigenen Blogbeitrag vor: 16.180 Token als HTML, 3.150 Token als Markdown, also rund 80 % weniger. Eine einfache Zwischenüberschrift koste in Markdown etwa 3 Token, als HTML mit Klassen und IDs 12 bis 15. Das sind Zahlen des Anbieters für eine einzelne Seite; wie viel sich bei Ihren Seiten spart, hängt davon ab, wie viel Code um den Text herum steht.

Entscheidend ist, wer die Markdown-Fassung überhaupt anfragt. Cloudflare nannte zum Start Coding-Agenten wie Claude Code und OpenCode, die den Header bereits senden. Für die großen KI-Suchen ist das nicht dokumentiert. Googles John Mueller berichtete im August 2026, auf seinen Testseiten würden nur SEO-Tools Markdown akzeptieren. Wenige Tage vor dem Cloudflare-Start hatte er das Ausliefern eigener Markdown-Dateien an Bots auf Bluesky als „a stupid idea“ bezeichnet; seine Kritik galt vor allem Lösungen, die Bots am User-Agent erkennen und ihnen eine andere Datei schicken.

Risiken und offene Fragen

Drei Punkte gehören vor jedes Einschalten:

• Nutzungssignal: Setzt Ihr Server keinen eigenen Content-Signal-Header, ergänzt Cloudflare standardmäßig ai-train=yes, search=yes, ai-input=yes. Damit erklären Sie, dass Inhalte auch für KI-Training genutzt werden dürfen. Wer das nicht will, setzt den Header am eigenen Server, den Cloudflare dann übernimmt.
• Gleicher Inhalt: Die Markdown-Fassung entsteht aus derselben Seite, das unterscheidet sie vom klassischen Cloaking. Riskant wird es, wenn Sie Markdown-Inhalte von Hand anders befüllen als die Seite für Menschen.
• Was im HTML fehlt, fehlt auch im Markdown: Cloudflare wandelt das HTML um, das vom Server kommt. Daraus folgt, dass Inhalte, die erst im Browser per JavaScript nachgeladen werden, in der Markdown-Fassung fehlen können. Dazu passt der Eintrag JavaScript-Rendering und KI.

Offen ist zudem, ob weitere Netzwerke und KI-Anbieter das Verfahren übernehmen. Ein verbindlicher Standard dafür, wie eine Markdown-Fassung aussehen soll, existiert Stand November 2026 nicht.

Praxis: ein angenommenes Beispiel

Ein angenommener Pumpenhersteller, pumpen-beispiel.de, betreibt seine Website hinter Cloudflare im Pro-Tarif. Der Wissensbereich unter /wissen/ enthält 120 technische Ratgeber, die Ingenieure zunehmend über KI-Assistenten und Coding-Agenten abfragen. Das Team geht in drei Schritten vor:

1. Messen: Vier Wochen lang protokolliert der Server den Accept-Header. Ergebnis: Ein kleiner Teil der Bot-Zugriffe fragt text/markdown an, überwiegend Entwicklerwerkzeuge und SEO-Tools.
2. Gezielt einschalten: Per Konfigurationsregel gilt Markdown for Agents nur für /wissen/. Shop und Konfigurator bleiben unberührt. Am eigenen Server setzt das Team Content-Signal: ai-train=no, search=yes, ai-input=yes.
3. Prüfen: Stichproben zeigen, ob Tabellen mit Fördermengen und Druckstufen im Markdown vollständig ankommen. Der Header x-markdown-tokens zeigt, wie stark jede Seite schrumpft.

Ergebnis: Agenten bekommen die Ratgeber schlanker, das Training ist ausgeschlossen, und das Team weiß, wie viele Agenten das Angebot tatsächlich nutzen. Eine bessere Platzierung in KI-Antworten erwartet es davon nicht. Dafür bleiben gute Inhalte, saubere Struktur und Erwähnungen auf anderen Seiten entscheidend, wie der Beitrag Wie werde ich in KI-Chatbots sichtbar? zeigt.