Guide

The llms.txt format, explained

llms.txt is a small Markdown file at your site’s root that hands large language models a clean, curated map of your most useful content. Here’s how to write one that scores 100.

Where it lives

Serve it as plain text at https://yourdomain.com/llms.txt. An optional companion, llms-full.txt, can hold the full expanded content.

The structure

The format uses Markdown in a fixed order so it’s both human- and machine-readable:

  1. An H1 title — the project or site name. This is the only required element.
  2. A blockquote summary — one or two sentences of essential context, right under the title.
  3. Optional free prose — a few sentences of detail, with no headings.
  4. H2 sections with link lists — grouped links to your key resources.
  5. An “Optional” section — links here are treated as lower priority and may be skipped for shorter context.

A minimal example

# Example Project

> A concise summary that gives an LLM the context it needs.

## Docs

- [Quick start](https://example.com/start): Get going in five minutes
- [API reference](https://example.com/api): Full endpoint docs

## Optional

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

Best practices

Frequently asked

Is llms.txt required?

No. It’s an emerging, voluntary standard. But as more AI tools read it, a clean file improves how your content is understood and surfaced.

How is the score calculated?

We weight structure (50%), link reachability (35%), and best practices (15%) into a single 0–100 score.

Validate your llms.txt →