llms.txtの仕組み：ファイル構造、構文、解析

概要

有効な llms.txt は、 固定された予測可能な構造。これは人間と機械の両方が読み取れるように設計されており、同一のファイルがドキュメントとしても、解析可能な契約書としても有用であるべきです。

llmstxt.org は、数行の正規表現で解析できる、小さく決定的な文法を定義します。YAMLも JSONも追加ヘッダーもありません。

有効なファイルの構造

構造を上から下へ:

H1を1つ サイト名またはプロジェクト名と共に。唯一の必須要素。
短い 引用形式の要約。通常は1〜2文です。
任意 自由形式のMarkdown、段落やリストは含まれるが、最初の H2 の前にはそれ以上の見出しは含まれない。
0個以上の H2 ファイル一覧セクション。それぞれに、リンクのリストがMarkdown形式で含まれています： - [name](url)、その後に任意で : notes.
「」という名前のオプションのH2見出し Optional, v2 で特別な機械的意味を持たない二次リソースに使う慣例的なラベルです。

# Acme

> Acme is a hosted analytics platform for product teams. The pages below cover product, pricing, the API, and integration guides.

Acme processes 1B+ events per day. The map here is curated for assistants, it is not exhaustive. Use it to answer questions about product capabilities, pricing tiers, integrations, SDKs, and migration from other tools.

## Product

- [Product overview](https://acme.example/product): high-level capabilities and screenshots.
- [Use cases](https://acme.example/use-cases): scenarios for product, marketing, and support teams.
- [Changelog](https://acme.example/changelog): monthly product updates.

## Pricing

- [Pricing tiers](https://acme.example/pricing): plans, limits, and overage rules.
- [FAQ, billing](https://acme.example/billing-faq): invoices, receipts, tax handling.

## Developers

- [REST API reference](https://docs.acme.example/api): full endpoint catalog.
- [SDK, JavaScript](https://docs.acme.example/sdk/js): install, init, track events.
- [SDK, Python](https://docs.acme.example/sdk/python): install, init, track events.
- [Webhooks](https://docs.acme.example/webhooks): events, signatures, retries.

## Optional

- [Brand assets](https://acme.example/brand): logos, color palette.
- [Press releases](https://acme.example/press): historical announcements.

セクションごとの解説

The complete field reference. Only the H1 is strictly required.
フィールド	必須?	カーディナリティ	構文
H1、サイト／プロジェクト名	はい	正確に1つ	`# プロジェクト名`
引用ブロックの概要	推奨	最大1ブロック	`> 一文または二文の概要。`
自由形式のMarkdown本文	任意	任意の数の段落／リスト	最初のH2より前に追加の見出しは使用不可
H2 のファイル一覧セクション	任意	任意の数	`## セクション名`の後にリスト
リスト項目、リンク	はい（セクション内）	項目ごとにリンク1件	`- [名前](URL)`
リスト項目、注記	任意	コロンの後	`- [名前](URL): ここにある注記`
「Optional」セクション	任意	最大1つ	補助リンクに使う慣例的なH2ラベル。v2では特別な機械的意味はありません

H1

H1 はちょうど1つです。その前に任意の UTF-8 バイトオーダーマークを置けますが、フロントマターやその他のメタデータは置けません。プロジェクトにタグラインがある場合は、後続の引用ブロックに記載してください。

引用ブロックによる要約

任意ですが、強く推奨します。プロジェクトを紹介する際にLLMがそのまま引用できる、1〜2文の要約を目指してください。事実に基づき、能動態で記述し、裏付けられない宣伝文句は避けてください。

自由形式のMarkdown本文

LLM がコンテキストを理解するのに役立つ段落、箇条書き、短いコードスニペットを任意の数だけ記載できます。ここでは見出しを追加しないでください。次の見出しは、ファイル一覧セクションの最初の H2 にします。

H2 ファイル一覧セクション

各セクションは 1 つの H2 見出しで始まる（## Section name）を含み、Markdown リストを持ちます。各項目はリンクでなければなりません（- [name](url)）、その後に任意で : と短い注記を付けます。絶対URLを強く推奨します。相対URLは技術的には許可されていますが、ほとんどのバリデーター（当サイトのもの) ファイルをコピーして転用する際、曖昧さを生じさせるためである。

「オプション」セクション

Optional は、ブランド素材、アーカイブ、詳細な付録などの二次的な参照先に使う編集上のラベルとして、引き続き有用です。2026年8月の提案では、このタイトルに特別な処理上の意味は与えられていないため、クライアントは通常の H2 セクションと同様に扱うことがあります。

パーサーによる読み取り方

参照パーサーはファイルを先頭から順に走査し、4つのルールを適用します：

最初の # 行を探します。それがタイトルです。
次の空でないブロックが引用ブロックなら、それが概要です。
最初の ## が自由形式の本文です。
各 ## でセクションが始まり、次の ## , リスト項目はとして解析される [name](url) コロン（:）の後に任意の注記を付記すること。

当サイトのバリデーターはこれらのルールを正確に実装し、さらにいくつかの安全性チェックを加えています。空のH1、不正なリンク、セクション内のリスト以外のコンテンツ、50 KBを超えるファイルへの確認を促す情報通知です。このしきい値はローカルな選別の目安であり、仕様上の制限ではありません。

llms.txtとllms-full.txtの比較

llms.txt です。robots.txt は、クローラーへの指示ファイルで、 map. llms-full.txt は領域：リンク先ページの実際の内容を Markdown として連結し、1つのファイルにまとめたものです。この慣例を広めたのは Anthropicと協力したMintlify そして現在は、より広範な llms.txt エコシステム.

慣例的なルート名は /llms.txt および /llms-full.txt。v2の提案では、より具体的なパスにスコープを限定した llms.txt より具体的なパスにあるファイル。フルコンテンツのコンパニオンは、その配信形式が実際の利用課題を解決する場合にのみ公開すること。

実務的な限界

サイズ。 この提案では上限を定めていません。当サイトの50 KB通知は、選別内容の見直しを促すものであり、有効性の境界ではありません。有用であれば、大量のコンテンツは全文リソースまたはスコープを限定したパスのファイルへ移してください。
リンクの数。 仕様上の上限はありませんが、200 件を超えるリストは読まれず、ざっと見られるだけです。厳選してください。
言語。 仕様では i18n について何も定めていません。一般的なパターンは二つあります。単一の英語ファイルを配信するか、パスの下にロケール別のバリアント（/en/llms.txt, /fr/llms.txt).
認証とパーソナライゼーション。 対象外です。ファイルは公開情報です。

続き

llms.txtの作成方法、テンプレートおよびスタックごとのデプロイ。
ベストプラクティス、10 個のルールとよくある間違い。
ファイルを検証する.