> For the complete documentation index, see [llms.txt](https://docs.varbase.vardot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.varbase.vardot.com/content-designers/search-engine-optimization/llms-txt.md).

# llms.txt and Markdown for AI Tools

AI assistants read websites to answer questions, and they prefer clean, well-structured text over pages full of layout. With the **Varbase AI Readable Base** recipe, a Varbase site offers two things to them: a short map of the site at `/llms.txt`, and a plain-text version of each post.

## The llms.txt File

`/llms.txt` is a short Markdown file for AI tools: the site's name, a short description, and the main sections with their links. On a Varbase Starter site it is built from the **Main navigation** and **Footer** menus, so it stays up to date as menus change.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-46404f29c83f8504ce24c4ff533d2d8598b1c77b%2Flearn-12-llms-txt-file.png?alt=media" alt="The llms.txt file as served by the site, with the site name, a Main navigation list of links to About Varbase, Features, Blog and Contact Us, and a Footer list"><figcaption><p>The llms.txt File Served by the Site</p></figcaption></figure>

### Editing It

1. Go to **Content** \ ***/llms.txt*** (`/admin/content/llms-txt`).
2. Edit **Content of the llms.txt**. It uses placeholders, such as the site name and slogan and the menus. **Browse available tokens** lists them.
3. Add a short paragraph about the organisation or links to key documents if useful, or add extra sections on the **/llms.txt sections** tab. Keep it short and factual: it is a signpost, not a brochure.
4. Click **Save configuration**.

<figure><img src="https://410909369-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzBcuWLZ87gvtX5vA2YGD%2Fuploads%2Fgit-blob-40b294456bac5b49aeb2e04ea93bffe0a76d9144%2Flearn-12-llms-txt-configuration.png?alt=media" alt="The llms.txt configuration tab with an explanation of llms.txt and the Content of the llms.txt field holding placeholders for the site name, slogan and main navigation"><figcaption><p>Editing the llms.txt Content</p></figcaption></figure>

If the site slogan is empty, the line it fills stays empty: fill **Slogan** in the site settings before launch. The **SEO Admin** and **Site Admin** roles can edit the file.

## Markdown Versions of Posts

Add `.md` to a post's address, such as `/blog/my-post.md`, to see its text without menus, scripts and layout. The normal page tells AI tools that this version exists, with a `rel="alternate" type="text/markdown"` link in its code. The pages visitors see do not change. Taxonomy terms have one too.

Drupal Canvas pages and listing pages have no Markdown version yet. They appear in `/llms.txt` as links, so AI tools can still find them.

## Content That AI Reads Well

The tools help, but the content matters most: clear headings, short paragraphs, plain words, and key facts (dates, names, prices, places) written as text, not inside images. The habits from [Creating Content](https://docs.varbase.vardot.com/content-designers/content-management.md) serve search engines, AI tools and people equally.

## Tips

* Decide with the client whether they welcome AI tools reading their content. Most organisations that publish public information do; some publishers ask certain AI crawlers to stay away in the robots file.
* The AI Readable Base recipe is alpha. The `/llms.txt` address needs a small exception in the site settings on some servers; add it to the deployment checklist.
* See [Varbase AI Readable Base](https://docs.varbase.vardot.com/developers/understanding-varbase/varbase-ai-recipes/varbase-ai-readable-base.md) for developers.
