The source is the “Format” section of the proposal (The /llms.txt file, v2), read as text for this site. Its words are quoted where a rule rests on them; the checks the explorer makes beyond them are marked as ours.
The parts, in order
| Part | Required | What the proposal says | What the explorer does |
|---|---|---|---|
| Byte-order mark | no | “An optional byte-order mark (BOM)”. | A node of its own; not counted as a line. |
| H1 | yes | “An H1 with the name of the project or site. This is the only required section.” | Issue if missing, if text comes before it, and for a second H1 (the proposal describes one; ours). The H1 may be written # Title or as a setext heading (a title line, then ===); the proposal shows only the first form, so the second is our reading of Markdown. |
| Blockquote | no | “A blockquote with a short summary of the project, containing key information necessary for understanding the rest of the file”. | Lines starting with > right after the H1; Issue if it comes later or inside a file list. |
| Details | no | “Zero or more markdown sections (e.g. paragraphs, lists, etc) of any type except headings”. | A heading between the summary and the first H2 is an Issue. |
| File lists | no | “Zero or more markdown sections delimited by H2 headers, containing ‘file lists’ of URLs”. | One group per H2. |
File list items
“Each ‘file list’ is a markdown list, containing a required markdown hyperlink [name](url), then optionally a
: and notes about the file.” The explorer reads a list item (-, *, + or a number) under an H2 as
a link item. An item with no link is an Issue (the real llms.txt of one site on this server writes
- Home: https://example.org/ and is read, with an Issue for each such line). Text after the link that does not begin with a colon is an Issue
(ours: the proposal shows the colon form only); closing bold or italic marks around the link (**[name](url)**) are not text after it. The URL may hold
balanced parentheses or be written in angle brackets (our reading of Markdown). A URL scheme other than http, https, mailto and ftp is noted.
Other text under an H2 is an Issue unless it is indented (read as a continuation), because the proposal describes lists only.
The Optional section
“The ‘Optional’ section is used, by convention, for secondary information: links an agent can skip when a shorter context is needed.” The explorer labels the section; it has no other effect.
Location
“The llms.txt file spec is for files named llms.txt, at the root path /llms.txt of a website or at any subpath
(e.g. /docs/llms.txt). A file covers the URLs under its path, and where more than one file applies, agents should use the
most specific one.” The proposal contrasts this with /.well-known/, which exists only at the origin root.