Najważniejsze wnioski w pigułce
Problem:
- Surowy HTML generuje 5x więcej tokenów niż markdown przy tej samej treści
- Przykładowy post blogowy: 16 180 tokenów w HTML vs 3 150 w markdown (redukcja o 80%)
- Agenci AI muszą samodzielnie konwertować HTML na markdown, co generuje dodatkowe koszty i opóźnienia
Rozwiązanie Cloudflare :
- Automatyczna konwersja HTML → markdown w czasie rzeczywistym na poziomie sieci CDN
- Wystarczy nagłówek
Accept: text/markdownw żądaniu HTTP - Funkcja dostępna dla planów Pro, Business i Enterprise oraz klientów SSL for SaaS
Korzyści biznesowe:
- Drastyczne obniżenie kosztów przetwarzania przez AI (80% mniej tokenów)
- Lepsza widoczność treści w wynikach agentów AI (ChatGPT, Claude i innych)
- Kontrola nad wykorzystaniem contentu przez nagłówki Content Signals
- Zero dodatkowej pracy — konwersja dzieje się automatycznie po stronie Cloudflare
Dlaczego markdown ma znaczenie dla przyszłości SEO
Sposób, w jaki użytkownicy odkrywają treści online, przechodzi fundamentalną zmianę. Tradycyjne wyszukiwarki ustępują miejsca agentom AI, które skanują web w poszukiwaniu strukturyzowanych danych. Problem? Internet został zbudowany dla ludzi, nie dla maszyn.
Feeding raw HTML to an AI is like paying by the word to read packaging instead of the letter inside — ta analogia Cloudflare trafnie opisuje problem. Prosty nagłówek ## O nas w markdown kosztuje około 3 tokeny. Ten sam nagłówek w HTML: `
O nas
pochłania 12-15 tokenów. Dolicz do tego
`, nawigację, skrypty i inne elementy bez wartości semantycznej — i masz przepis na marnotrawstwo zasobów.
Markdown stał się de facto językiem wspólnym dla agentów AI. Jego jawna struktura ułatwia przetwarzanie, co przekłada się na lepsze wyniki przy minimalnym zużyciu tokenów. Problem w tym, że web składa się z HTML, a rozmiar stron systematycznie rośnie od lat.
Jak działa automatyczna konwersja HTML na markdown
Cloudflare wprowadził rozwiązanie: konwersja treści w czasie rzeczywistym bezpośrednio w sieci CDN. Gdy agent AI odpytuje stronę z włączoną funkcją Markdown for Agents, wystarczy że w żądaniu doda preferencję text/markdown. Sieć Cloudflare automatycznie pobierze HTML z origin, przekonwertuje na markdown i zwróci agentowi.
Przykład żądania z użyciem curl:
curl https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/ \
-H "Accept: text/markdown"
Dla programistów budujących agenty w Cloudflare Workers dostępny jest TypeScript:
const r = await fetch(
`https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/`,
{
headers: {
Accept: "text/markdown, text/html",
},
}
);
const tokenCount = r.headers.get("x-markdown-tokens");
const markdown = await r.text();
Odpowiedź zawiera nagłówek x-markdown-tokens z oszacowaną liczbą tokenów w dokumencie. Ta informacja pozwala precyzyjnie zarządzać rozmiarem okna kontekstowego czy strategią dzielenia treści na fragmenty.
Content Signals — kontrola nad wykorzystaniem treści
Zwracając markdown, każda firma chce mieć pewność, że jej treści są właściwie wykorzystywane przez agenty AI. Dlatego odpowiedzi Markdown for Agents zawierają nagłówek:
Content-Signal: ai-train=yes, search=yes, ai-input=yes
To jasny sygnał, że treść może być używana do treningu AI, wyników wyszukiwania i jako input dla agentów. Framework Content Signals, ogłoszony przez Cloudflare podczas Birthday Week, pozwala wydawcom kontrolować, jak ich content jest wykorzystywany po pobraniu.
W przyszłości Markdown for Agents umożliwi definiowanie własnych polityk Content Signals, co da jeszcze większą kontrolę nad dystrybucją treści w ekosystemie AI.
Praktyczne zastosowania i pomiar efektywności
Cloudflare już włączył tę funkcję na swoim blogu i w dokumentacji developerskiej. Popularne agenty kodujące — Claude Code i OpenCode — już dziś wysyłają odpowiednie nagłówki accept w swoich żądaniach.
Dla firm, które potrzebują konwersji dokumentów spoza Cloudflare lub gdy Markdown for Agents nie jest dostępny u dostawcy treści, Cloudflare oferuje alternatywne metody:
- Workers AI z funkcją
AI.toMarkdown()— obsługuje wiele typów dokumentów, nie tylko HTML - Browser Rendering
/markdownREST API — przydatny dla dynamicznych stron wymagających renderowania w przeglądarce
Cloudflare Radar wprowadził nowe metryki content type insights dla ruchu botów AI. Wymiar content\_type i filtry pokazują dystrybucję typów treści zwracanych agentom, pogrupowanych według kategorii MIME. Te dane pozwolą śledzić ewolucję sposobu, w jaki boty AI konsumują treści webowe.
Jak włączyć Markdown for Agents w swojej witrynie
Aktywacja funkcji wymaga zaledwie kilku kliknięć. Wystarczy zalogować się do panelu Cloudflare, wybrać domenę, odnaleźć Quick Actions i przełączyć przycisk Markdown for Agents.
Funkcja jest obecnie dostępna w wersji beta bez dodatkowych opłat dla planów Pro, Business i Enterprise oraz klientów SSL for SaaS. To moment, by przestać myśleć tylko o ludzkich odwiedzających i tradycyjnym SEO — czas traktować agenty AI jako pełnoprawnych użytkowników.
Dla firm oznacza to konkretne korzyści: 80% redukcja kosztów tokenów, lepsza widoczność w wynikach AI, kontrola nad wykorzystaniem treści i zero nakładu pracy developerskiej. Konwersja dzieje się transparentnie po stronie CDN.
Podsumowanie: Markdown for Agents to odpowiedź na zmieniający się sposób odkrywania treści w internecie. Redukcja o 80% zużycia tokenów przy automatycznej konwersji HTML na markdown czyni tę funkcję must-have dla każdej firmy, która chce pozostać widoczna w erze agentów AI.
Źródło: Cloudflare Blog, “Introducing Markdown for Agents”, 12 lutego 2026
