CloudflareのMarkdown for AgentsでサイトをMarkdown化する

2/14/2026 · 2 min read

cloudflare ai tips

AIエージェントがWebサイトのコンテンツを読み取る際、HTMLのタグやスタイル情報は不要なトークンを消費します。

CloudflareでMarkdown for Agentsを有効にすれば、HTMLページをリアルタイムでMarkdownに変換してAIに配信できるようになり、トークン使用量を削減することができます。

Table of Contents

• Markdown for Agentsとは
• 仕組み
• 有効化の方法
• 動作確認
• まとめ

Markdown for Agentsとは

Markdown for Agentsは、Cloudflareのネットワークを通じて配信されるHTMLページを、リクエスト時にリアルタイムでMarkdownに変換する機能です。

MarkdownはAIが処理しやすいフォーマットで、HTMLと比較して不要なタグやスタイル情報が除去されるため、トークン消費を大幅に削減できます。

対応プラン: Pro、Business、Enterprise、SSL for SaaS（追加費用なし）

仕組み

Markdown for Agentsは、HTTPのコンテンツネゴシエーションを利用します。

1. AIエージェントがリクエスト時に Accept: text/markdown ヘッダーを送信
2. Cloudflareがこれを検知し、オリジンからHTMLを取得
3. HTMLをMarkdownに変換してレスポンスを返す

レスポンスには以下のヘッダーが含まれます。

x-markdown-tokens を使えば、コンテキストウィンドウのサイズ計算やチャンキング戦略の判断に活用できます。

制限事項

• オリジンが content-length ヘッダーを返さない場合は変換不可
• 1MBを超えるドキュメントは変換不可
• 圧縮されたオリジンレスポンスは非対応
• ゾーン単位での設定（サブドメインごとの切り替えには別ゾーンが必要）

有効化の方法

ダッシュボードから有効化する

1. Cloudflareダッシュボードにログイン
2. 対象のアカウントとゾーンを選択
3. AI Crawl ControlのoverviewページでQuick Actions を見つける
4. Markdown for Agents をトグルでオンにする

APIから有効化する

curl -X PATCH \
  "https://api.cloudflare.com/client/v4/zones/{zone_id}/settings/content_converter" \
  -H "Authorization: Bearer {api_token}" \
  -H "Content-Type: application/json" \
  -d '{"value": "on"}'

APIトークンには Zone Settings edit 権限が必要です。

動作確認

curl で、簡単に確認することができます。

curl --dump-header - https://murajun1978.dev/blog/cloudflare-markdown-for-agents/ -H "Accept: text/markdown"

レスポンスがMarkdown形式で返ってくれば成功です。x-markdown-tokens ヘッダーも確認できますね。

# HTTP/2 200
# date: Sun, 15 Feb 2026 03:53:33 GMT
# content-type: text/markdown; charset=utf-8
# content-length: 6112
# vary: accept
# x-markdown-tokens: 1081
# content-signal: ai-train=yes, search=yes, ai-input=yes
# server: cloudflare
# cf-ray: 9ce1dbdd8cdccffe-KIX

---
description: CloudflareのMarkdown for Agents機能を使って、WebサイトのHTMLを自動的にMarkdown形式でAIエージェントに配信する方法を解説します。
title: CloudflareのMarkdown for AgentsでサイトをMarkdown化する | murajun1978.dev
image: https://murajun1978.dev/images/cloudflare-markdown-for-agents.png
---

AIエージェントがWebサイトのコンテンツを読み取る際、HTMLのタグやスタイル情報は不要なトークンを消費します。

CloudflareでMarkdown for Agentsを有効にすれば、HTMLページをリアルタイムでMarkdownに変換してAIに配信できるようになり、トークン使用量を削減することができます。

...

まとめ

Markdown for Agentsは、Cloudflareダッシュボードのトグルひとつで有効化でき、AIエージェントに対してトークン効率の良いMarkdownを自動配信できる機能です。

サイトのコード変更は一切不要で、Cloudflareのエッジでリアルタイムに変換が行われます。

Pro以上のプランを利用している方は、ぜひ試してみてください😊

参考

• Introducing Markdown for Agents
• Markdown for Agents(docs)