llms.txt のフォーマット、仕様リファレンス

フォーマットの概要

llms.txt は、次を使用するプレーンテキストリソースです： CommonMark Markdown。オリジンのルート、または https://example.com/docs/llms.txt。最も具体的な 適用対象となるファイルがその範囲を記述している。

互換性のあるコーディングアシスタント、RAGパイプライン、およびリサーチエージェントは、このファイルをキュレーション済みの マップとして利用できます。公開されただけでは発見や使用を証明するものではないため、以下のように宣言してください。 rel="describedby" 適切な場所で、実際に対応するクライアントを測定します。

必須要素

2026年8月の提案では、必須要素を1つ定めています：

1. H1見出し、最初の行はH1でなければならない（# Name) に プロジェクト名またはサイト名が含まれているもの。

ブロッククォートの要約、説明的な前文、H2見出しのファイル一覧、およびリンクに関する注記は任意です。

# Your Project Name

> One sentence describing what your project does and who it's for.

## Documentation

- [Getting Started](https://example.com/docs/start): Install and first steps.
- [API Reference](https://example.com/api): Full endpoint catalog.

## Optional

- [Changelog](https://example.com/changelog): Release history.

任意のセクション

セクションは H2 見出し（##）と、その後に続くMarkdownリンクの順不同リストで構成されます。一般的なセクション名は次のとおりです：

• ドキュメント、主要ドキュメント、ガイド、リファレンス。
• 製品、マーケティングページ、価格、ステータス。
• 例、コードサンプル、チュートリアル、デモ。
• 任意、変更履歴、ブログ、GitHub、AIに関する優先度は低い。
• API、専用のAPIリファレンスセクション。
• SDKs、言語別のクライアントライブラリ。

任意 は二次情報源に対する明確な編集上のラベルとして残っているが、v2では これに対する特別な処理セマンティクスは割り当てられていない。

# Acme SaaS

> Acme SaaS helps teams automate their billing workflows with a no-code dashboard
> and a REST API supporting 40+ payment providers.

## Product

- [Overview](https://acme.com/product): Core capabilities and use cases.
- [Pricing](https://acme.com/pricing): Plans, limits, and enterprise options.
- [Status](https://status.acme.com/): Uptime and incident history.

## Documentation

- [Quickstart](https://acme.com/docs/quickstart): Set up in under 5 minutes.
- [API Reference](https://acme.com/docs/api): REST endpoints, auth, rate limits.
- [SDKs](https://acme.com/docs/sdks): Node, Python, Ruby, Go clients.
- [Webhooks](https://acme.com/docs/webhooks): Event payloads and retry policy.

## Examples

- [Node.js integration](https://acme.com/examples/node): End-to-end payment flow.
- [Python integration](https://acme.com/examples/python): Subscription management.

## Optional

- [Changelog](https://acme.com/changelog): Version history.
- [Blog](https://acme.com/blog): Product updates and tutorials.
- [GitHub](https://github.com/acme/acme-oss): Open-source components.

リンク構文

各リンクは Markdown 構文に従います - [Title](URL): short description.

• 使用します 絶対URL スキームを含むhttps://).
• コロンの後の説明はプレーンテキストです。約120文字以内に抑え、キーワードを詰め込まず、AIにとって有益な内容にしてください。
• リスト項目ごとにリンクは1つとし、箇条書きをネストしないでください。
• 正規URLを優先してください（末尾のスラッシュが慣例なら、それも含めます）。

llms-full.txtの派生形式

より広範なエコシステムでは、以下の場所にあるオプションの付随ファイルが使用されています。 /llms-full.txt。一方、 llms.txt はリンクのインデックスであり、 llms-full.txt は 全文 リンクされたページの本文を連結し、Markdown 形式にしたものです。

この慣例に明示的に対応するツールは、統合されたコンテキストを得るために llms-full.txt により、コンテキストを統合できます。その代わり、サイズ、陳腐化、セキュリティ上の露出が増えます。

専用の llms-full.txtガイド 生成方法について。

チェックリスト

• ルートまたは意図した範囲のパスで配信されるファイル
• UTF-8 エンコーディングのプレーンテキストまたは Markdown メディアタイプ
• 正確に1つのH1見出しで始まる
• 任意の引用ブロックと前文に見出しが含まれていないこと
• リンク先が公開時のコンテキストで正しく解決される
• 任意のリンク注記は簡潔かつ事実に基づくものとする。
• ファイルサイズがタスクとテスト済みクライアントによって正当化されている
• HTMLタグやネストされたリストは使用しないでください
• で検証済み llms.txt バリデーター

よくある間違い

• 相対URL, - [Docs](/docs) は、AIクローラーがファイルを取得した際に正しく解決されません。必ず絶対URLを使用してください。
• 引用ブロックの欠落、これは v2 準拠エラーではありません。 短い事実の要約が対象となるクライアントの役に立つ場合にのみ、これを追加してください。
• Content-Typeの誤り, 提供元： text/html 、またはcontent-typeがない場合、一部のパーサーがファイルを拒否します。
• 説明文へのキーワードの詰め込み、AIモデルはこれらを文字どおり読み取ります。キーワードを詰め込むと 品質シグナルが低下します。
• すべてのページを列挙すること。最も重要なリンクを10〜30件に厳選してください。 sitemap.xml を網羅的なURL探索に使用します。関連する llms-full.txt は、明示的に互換性のある取り込みワークフロー向けにコンテンツをまとめられますが、サイトマップの代わりにはなりません。

関連ガイド

• llms.txtの作成方法、あらゆるスタックに対応したステップバイステップの手順。
• llms-full.txtガイド、全文を収める関連ファイル。
• バリデータ、ファイルが仕様に準拠しているか確認します。
• ジェネレーターでは、フォームからファイルを作成できます。
• ベストプラクティス、含めるものと省くもの。
• どのAIクローラーがllms.txtを読み取るか、採用状況。