Wir haben das Konzept, die Adoptionsdaten und die Implementierungsoptionen für verschiedene Plattformen zusammengestellt, damit Sie einschätzen können, ob und wann Markdown for Agents für Ihre Website sinnvoll ist.
HTML ist für Browser, Markdown für Agenten
KI-Agenten verarbeiten Text in Token: kleine Texteinheiten, in denen Sprachmodelle Inhalte lesen. Jedes Kontextfenster hat eine feste Kapazität. Was nicht hineinpasst, wird nicht verarbeitet.
Für Publisher bedeutet das: Je mehr Token eine Seite belegt, desto weniger Inhalt kommt ungekürzt beim Agenten an. HTML belegt viele Token für Dinge, die ein Agent nie braucht.
Ein typischer Artikel in HTML enthält: Stylesheet-Verweise, Script-Tags, Navigationsmenüs, Wrapper-Divs, Klassen-Attribute, ARIA-Labels, Schema.org-Markup, Footer-Code. Derselbe Artikel als Markdown enthält: Überschriften, Absätze, Links. Das war es.
Was ein Browser lädt:
<!DOCTYPE html> <html lang="de"> <head> <link rel="stylesheet" href="/css/main.css"> <script defer src="/js/bundle.js"></script> <script defer src="/js/analytics.js"></script> </head> <body> <header class="site-header sticky" role="banner"> <nav class="main-nav" role="navigation"> <ul><li><a href="/">Start</a></li><li><a href="/leistungen">Leistungen</a></li></ul> </nav> </header> <main class="layout" id="main-content" role="main"> <article class="post" itemscope itemtype="https://schema.org/Article"> <h1 class="post-title" itemprop="headline">Über uns</h1> <div class="post-body prose" itemprop="articleBody"> <p>Wir sind eine SEO-Agentur aus Wien.</p> </div> </article> </main> <footer class="site-footer">...</footer> <script src="/js/interactions.js"></script> </body> </html>
Was ein KI-Agent braucht:
# Über unsWir sind eine SEO-Agentur aus Wien.
Der Inhalt ist identisch. Der Unterschied liegt im Rauschen drumherum. Cloudflare maß das an einem eigenen Blog-Artikel: 16.180 Token als HTML, 3.150 Token als Markdown, eine Reduktion um 80 Prozent. Vercel verzeichnete bei technischer Dokumentation 99,6 Prozent Reduktion (500 KB HTML, 2 KB Markdown).
Die Konsequenz für Ihre Inhalte: Wenn das Kontextfenster mit HTML-Rauschen gefüllt ist, kommen wichtige Inhalte, Produktdetails, Preise, Argumente, nicht vollständig beim Agenten an. Markdown-Auslieferung schützt, was zählt.
Was ist Markdown for Agents?
Das Prinzip dahinter heißt HTTP Content Negotiation: Ein Agent teilt dem Server im Request-Header mit, welche Formate er verarbeiten kann. Browser senden Accept: text/html. KI-Agenten, die Markdown bevorzugen, senden Accept: text/markdown. Der Server antwortet jeweils im passenden Format, ohne zwei separate Seiten pflegen zu müssen.
Das Konzept ist nicht neu. JSON/XML-APIs nutzen denselben Mechanismus seit Jahrzehnten. Neu ist die Anwendung für KI-Agenten. Der text/markdown-Media-Type ist seit 2016 formal registriert (IANA, RFC 7763), der Accept-Header ist HTTP-Standard. Kein proprietärer Vorschlag, kein neues Format.
Was Cloudflare im Februar 2026 unter dem Namen "Markdown for Agents" lanciert hat, ist die bislang einfachste Implementierung: die Konvertierung passiert am CDN-Layer, ohne Eingriff am Server. Für Websites ohne Cloudflare gibt es WordPress-Plugins, CMS-Module und selbst hostbare Lösungen.
Wer das Markdown heute schon abruft
Hier ist eine wichtige Unterscheidung notwendig: Coding Agents (aktive Werkzeuge, die HTTP-Anfragen stellen) und Web Crawlers (indexierende Bots wie GPTBot oder ClaudeBot) verhalten sich unterschiedlich.
Checkly testete 7 große Coding Agents im Februar 2026: 3 von 7 senden den Accept: text/markdown-Header bereits aktiv.
| System | Typ | Sendet Accept: text/markdown |
|---|---|---|
| Claude Code | Coding Agent | ✓ Ja |
| Cursor | Coding Agent | ✓ Ja |
| OpenCode | Coding Agent | ✓ Ja |
| OpenAI Codex CLI | Coding Agent | ✗ Nein |
| Gemini CLI | Coding Agent | ✗ Nein |
| GitHub Copilot | Coding Agent | ✗ Nein |
| GPTBot, ClaudeBot, Google-Extended | Web Crawler | ✗ Nein |
Web Crawlers entdecken Markdown-Inhalte aktuell über zwei alternative Wege: einen <link rel="alternate" type="text/markdown" href="...">-Tag im HTML-Head oder dedizierte URLs wie /seite.md. Dries Buytaert (Drupal-Gründer) dokumentierte das in einem eigenen Experiment: Crawlers folgten dem Alternate-Link-Tag und riefen die Markdown-URL proaktiv ab, ohne den Accept-Header zu senden.
Vergleich mit llms.txt
Die Ausgangslage ist substanziell stärker als bei llms.txt. llms.txt basiert auf einer neuen Konvention ohne RFC-Rückhalt, die Google explizit abgelehnt hat. Accept: text/markdown nutzt einen 27 Jahre alten HTTP-Standard, einen IANA-registrierten Media Type und Cloudflare-Infrastruktur für rund 20 % des Webs. Die ersten Coding Agents nutzen es heute bereits. Google-Vertreter sind skeptisch ("warum brauchen KI-Systeme Markdown, wenn sie auf normalen Webseiten trainiert haben?"), aber das Signal ist deutlich belastbarer als bei llms.txt.
Agent-Optimierung: mehr als Markdown.
Markdown for Agents ist ein Baustein. Wir zeigen, welche Maßnahmen für Ihre Website den größten Unterschied machen, und setzen das mit Ihnen um.
Implementierungsoptionen im Überblick
Drei Plattformen decken den Großteil der praktizierten Implementierungen ab. Alle liefern dasselbe Ergebnis: Markdown, wenn ein Agent fragt, HTML, wenn ein Browser fragt.
Cloudflare
Native CDN-Funktion seit Februar 2026. Die Konvertierung passiert am CDN-Layer, kein Eingriff am Origin-Server nötig. Voraussetzung: Pro-, Business- oder Enterprise-Plan (aktuell kostenlos, Beta).
Aktivierung: Cloudflare Dashboard, Zone auswählen, unter "AI Crawl Control" den Schalter "Markdown for Agents" einschalten. Test per HTTP-Request mit Accept: text/markdown-Header: die Response enthält Markdown und den Header x-markdown-tokens mit der Token-Zahl. Monitoring: Cloudflare Radar schlüsselt KI-Bot-Traffic nach Content-Type auf.
WordPress
Auf wordpress.org sind über 8 Community-Plugins verfügbar, alle seit Februar 2026. Drei Empfehlungen je nach Anforderung:
Serve Markdown: Einstiegsempfehlung. Reagiert auf Accept: text/markdown und fügt automatisch einen <link rel="alternate">-Tag ein, damit auch Crawlers die Markdown-Version entdecken.
Mescio for Agents: Empfehlung für WooCommerce-Shops. Verarbeitet Gutenberg-Blöcke vollständig vor der Konvertierung und liefert Produktinhalte korrekt als Markdown aus.
md4AI: Erkennt bekannte KI-Agenten per User-Agent und liefert Markdown auch ohne Accept-Header. Höchste Abdeckung, etwas mehr Konfigurationsaufwand.
Vercel / Next.js
Kein natives Feature, aber gut dokumentierter DIY-Ansatz via Edge Middleware: eine Middleware-Funktion prüft den Accept-Header und leitet die Anfrage an einen Markdown-Konverter weiter. Vercel setzt diesen Ansatz intern selbst ein, Contentful-Content wird zu Markdown konvertiert und per Content Negotiation ausgeliefert.
Einstieg: vercel.com/blog ("Making Agent-Friendly Pages") und vercel.com/kb. Aufwand: einige Stunden für eine produktionsreife Middleware.
Weitere Plattformen
| Plattform | Fertige Lösung | Lösung / Hinweis |
|---|---|---|
| Drupal | ✓ Ja | Markdownify-Modul (Community), Accept-Header und dedizierte .md-URL-Pfade |
| Nginx | ✓ Ja | Community-Modul (GitHub), Rust-basierte Konvertierung, selbst hostbar |
| Netlify, Fastly | ✗ Nein | Kein natives Feature angekündigt |
| AWS CloudFront | ✗ Nein | Kein natives Feature angekündigt |
| Webflow, Shopify, Squarespace | ✗ Nein | Architektonisch schwierig ohne CDN-Layer davor |
Was Markdown for Agents nicht leistet
Markdown-Auslieferung verbessert, wie gut ein Agent Ihre Inhalte lesen kann. Es beeinflusst nicht, ob er Ihre Website überhaupt aufruft. Drei Grenzen sollte man kennen:
ChatGPT, Google AI Overviews und Perplexity entscheiden nicht aufgrund von Markdown-Auslieferung, ob sie eine Website zitieren. Zitierfähige Inhalte, E-E-A-T (Erfahrung, Expertise, Autorität, Vertrauenswürdigkeit) und strukturierte Daten bleiben die maßgeblichen Hebel.
Damit Markdown ausgeliefert wird, muss der Agent die Seite zuerst finden und abrufen. Für Coding Agents gilt das heute schon. Für Web Crawlers braucht es zusätzlich einen <link rel="alternate">-Tag oder dedizierte .md-URLs als Entdeckungsmechanismus.
Schlechte Inhalte in Markdown sind schlechte Inhalte. Token-Effizienz hilft nur, wenn der reduzierte Inhalt tatsächlich das enthält, was der Agent sucht: konkrete Antworten, klare Struktur, verlässliche Fakten.
Markdown-Auslieferung ist kein Selbstzweck. Sinnvoll eingesetzt, senkt sie die Hürde für Agenten, die ohnehin auf Ihre Website kommen. Was sie auf Ihrer Website finden und tun sollen — Formulare ausfüllen, Kaufabschlüsse vorbereiten, Dokumentation durchsuchen — ist eine andere Frage. Die behandelt Agent-Optimierung ausführlich: von Formular-Accessibility über semantisches HTML bis zu den technischen Voraussetzungen.
Ihre Website fit für KI-Agenten machen?
Markdown for Agents ist in den meisten Fällen in unter einer Stunde erledigt. Was danach kommt, hängt davon ab, welche Agenten Ihre Zielgruppe nutzt und was sie auf Ihrer Website tun sollen. Das besprechen wir gerne.
Gespräch anfragenHäufige Fragen
- Welche Cloudflare-Pläne unterstützen Markdown for Agents?
- Pro-, Business- und Enterprise-Plan, sowie SSL for SaaS. Der Free-Plan ist nicht berechtigt. Das Feature ist aktuell kostenlos (Beta-Status seit Februar 2026).
- Muss ich etwas am Server oder am Code ändern?
- Bei Cloudflare: nein. Ein Schalter im Dashboard genügt. Bei WordPress: Plugin installieren und aktivieren. Bei Vercel oder selbst gehostetem Nginx ist etwas Konfigurationsarbeit nötig, aber kein Eingriff am Inhalt selbst.
- Liest ChatGPT, Perplexity oder Google das Markdown?
- Nicht über den Accept-Header. Diese Systeme senden ihn nicht aktiv. Sie können Markdown-Inhalte aber über Alternate-Link-Tags oder dedizierte .md-URLs entdecken und abrufen. Den größten sofortigen Effekt hat Markdown-Auslieferung bei Coding Agents wie Claude Code, Cursor und OpenCode.
- Welches WordPress-Plugin eignet sich?
- Für die meisten Websites ist Serve Markdown ein naheliegender Einstieg: einfach, sauber, unterstützt den Alternate-Link-Tag für Crawler-Discovery. Für WooCommerce-Shops bietet sich Mescio for Agents an, weil es Produktdaten vollständig verarbeitet. Wer auch Agents ohne Accept-Header erreichen möchte, kann md4AI in Betracht ziehen. Das Ökosystem ist jung, ein direkter Vergleich lohnt sich vor der Entscheidung.
- Was ist der Unterschied zu llms.txt?
- Verschiedene Konzepte für verschiedene Zwecke. llms.txt ist eine statische Datei mit einer kuratierten Inhaltsübersicht — ein Inhaltsverzeichnis für Agenten. Markdown for Agents liefert die vollständigen Seiteninhalte in einem für Agenten lesbaren Format. Beides kann sinnvoll nebeneinander existieren: llms.txt zeigt, welche Seiten relevant sind. Markdown for Agents sorgt dafür, dass diese Seiten effizient gelesen werden können.
- Schadet Markdown-Auslieferung dem SEO?
- Nein. Googlebot sendet keinen
Accept: text/markdown-Header und erhält weiterhin HTML. Die Markdown-Antwort wird nur ausgeliefert, wenn ein Agent sie explizit anfordert. Durch denVary: Accept-Header in der Response stellt Cloudflare sicher, dass Caches HTML- und Markdown-Versionen korrekt getrennt behandeln.
Kontakt
traffic3 GmbH | SEO- und GEO-Beratung
E-Mail: office@traffic3.net
Telefon: +43 1 890 80 50
Kontaktformular: Zum Kontaktformular
Standort: Dapontegasse 2/7, 1030 Wien, Österreich
Fokus: DACH-Region (Deutschland, Österreich, Schweiz)
Weiterführende Artikel
llms.txt: Sinnvolles GEO-Signal oder überflüssiger Hype?
Studiendaten, Praxisbeispiel und ehrliche Einordnung: Was llms.txt bewirkt und wann es sich lohnt.
WeiterlesenGEO-Maßnahmen im Überblick
Strukturierte Daten, zitierfähige Inhaltsformate, robots.txt-Konfiguration: Was konkret für KI-Sichtbarkeit wirkt.
WeiterlesenGEO: Sichtbarkeit in KI-Systemen
Was Generative Engine Optimization ist, wie KI-Systeme Inhalte auswählen und welche Maßnahmen Wirkung zeigen.
WeiterlesenAgent-Optimierung: Websites für KI-Agenten nutzbar machen
Markdown-Auslieferung ist ein Baustein. Was Agenten sonst noch brauchen: Formular-Accessibility, semantisches HTML, robots.txt-Konfiguration.
Weiterlesen