Free llms.txt validator

llms.txt Checker

Validate any llms.txt file against the official llmstxt.org specification

Paste a URL or the raw file and this checker parses it the way an AI crawler would — confirming the markdown structure, the required H1 title, the blockquote summary, the detail blocks and every H2 file list, then telling you exactly which line to fix.

Free
No sign-up
Follows the llmstxt.org spec
URL or pasted content

A bare domain works — we add https:// and look for /llms.txt and /llms-full.txt at the site root.

What is llms.txt?

llms.txt is a markdown file published at the root of a website — yourdomain.com/llms.txt — that gives large language models a short, curated map of the site. Instead of asking a model to crawl navigation, scripts and boilerplate, the file hands it a title, a summary and a list of the pages that actually matter.

The format is defined by the specification at llmstxt.org. It is deliberately small: only H1 and H2 headings exist, and the body of each section is a list of links. That constraint is what makes the file both human-readable and trivially parseable by a program.

The spec also describes a companion convention, /llms-full.txt, which contains the expanded content itself rather than an index of links.

The required order, per the spec

  1. 1An optional byte-order mark at the very start of the file.
  2. 2An H1 with the name of the project or site — the only required section.
  3. 3A blockquote with a short summary containing the key information needed to understand the rest of the file.
  4. 4Zero or more markdown blocks — paragraphs, lists, tables — of any type except headings.
  5. 5Zero or more sections delimited by H2 headers, each containing a file list of `- [name](url)` items with optional `: notes`.
  6. 6A section named exactly “Optional” has special meaning: its URLs may be skipped when a shorter context is needed.

The 5 validation rules we check

Every check maps directly to a clause in the llmstxt.org specification. Each rule is scored, and the weighted total becomes your compliance score and letter grade.

1

Markdown format

markdown-format
The file must be markdown, and only H1 and H2 headings exist in the format.

Serve plain markdown at /llms.txt — no HTML, no YAML front-matter, no H3–H6 headings. Anything deeper than an H2 is outside the specification.

2

H1 project title

h1-title
An H1 with the name of the project or site. This is the only required section.

Start the file with a single `# Your Site Name` line. It is the one part of the spec that is mandatory, and there should be exactly one of them.

3

Blockquote summary

blockquote-summary
A blockquote with a short summary of the project, containing key information necessary for understanding the rest of the file.

Put a `> one-paragraph summary` directly under the H1. Say what the site is and who it serves, so a model can interpret every link below it.

4

Detail blocks without headings

project-details
Zero or more markdown sections (for example paragraphs, lists, tables) of any type except headings, containing more detailed information.

Add optional context after the summary as paragraphs, lists or tables. Do not use a heading here — the next heading in the file should be your first H2 section.

5

H2 sections with file lists

file-lists
Zero or more markdown sections delimited by H2 headers, containing file lists of URLs where further detail is available.

Group links under `## Section name` headings, one link per line as `- [Name](https://absolute-url): optional notes`. A section named exactly `Optional` may be skipped when a shorter context is needed, so keep it last.

How to write a compliant llms.txt

Implementation guide

Six decisions that keep the file inside the spec.

  1. 1Open with one H1. Use your site or project name — nothing above it except an optional byte-order mark. This is the only section the spec requires.
  2. 2Add the blockquote summary. One `>` paragraph directly under the H1 explaining what the site is, so the links below have context.
  3. 3Keep detail blocks heading-free. Extra paragraphs, lists or tables are allowed after the summary — but no headings until your first H2.
  4. 4Group links under H2 sections. Name sections after what a model would look for: Docs, Guides, API, Blog. Only H1 and H2 exist in this format.
  5. 5Write file-list items exactly. `- [Page name](https://example.com/page): short note`. Use absolute URLs so a model can resolve them without a base URL.
  6. 6Put “Optional” last. A section titled exactly Optional may be skipped when a shorter context is needed. Reserve it for secondary pages and keep it at the end.

The spec template

The canonical example published at llmstxt.org — copy it and fill in your own values.

# Title

> Optional description goes here

Optional details go here

## Section name

- [Link title](https://link_url): Optional link details

## Optional

- [Link title](https://link_url)

Save it as llms.txt and upload it to your site root so it is served at yourdomain.com/llms.txt, then run it back through this checker.

How to use this checker

  1. 1

    Pick an input mode

    Choose Check by URL to validate a file that is already live, or Paste content to validate a draft before you publish it.

  2. 2

    Enter your URL or file

    Type a bare domain, a site root, or a direct /llms.txt URL — the protocol is added for you. In paste mode, drop the full markdown into the text box.

  3. 3

    Run the check

    Press Check or Validate. The file is fetched, split into specification blocks, and scored against the five structural rules.

  4. 4

    Read the score and grade

    The score ring shows weighted compliance out of 100 with a letter grade, plus how many rules passed, warned, or failed.

  5. 5

    Work through the findings

    Each finding names the rule, the line number, and the exact change to make. Expand a rule card to see every detail behind its status.

  6. 6

    Fix, publish, and re-check

    Apply the fixes, upload the file to your site root so it is served at yourdomain.com/llms.txt, then run the URL back through the checker to confirm it passes.

Frequently asked questions about llms.txt

Related tools

The specification this checker follows is published and maintained at llmstxt.org.