---
title: "Usage"
manual: "LLMs.txt Generator"
version: "main"
permalink: "https://docs.typo3.org/permalink/rtfirst/llms-txt:usage@main"
source: "Usage.rst"
rendered: "2026-10-02T09:37:21+00:00"
---

# Usage {#usage}

This chapter explains how to access the LLM-optimized content.

## Accessing llms.txt {#usage-llms-txt}

The llms.txt index file is available at the root of your website, and below
the base of every further language (see [Multi-Language Access](https://docs.typo3.org/permalink/rtfirst/llms-txt:usage-multi-language@main)):

```text
https://example.com/llms.txt
https://example.com/en/llms.txt
```

This file contains:

-   Website metadata (title, description, domain)
-   Page structure with descriptions and keywords
-   Instructions for accessing page content in Markdown format (if
    [llmsTxt.enableMarkdown](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-enablemarkdown@main) is enabled)

### Example llms.txt Output {#usage-llms-txt-example}

```markdown
# My Website

> Your expert for quality products and services.

**Specification:** <https://llmstxt.org/>
**Domain:** https://example.com
**Language:** de
**Generated:** 2026-01-31 12:00:00

This site provides LLM-friendly Markdown output for all content pages.

**Markdown Format:** Append `.md` to a page URL to get plain Markdown with YAML frontmatter. Pages that only link to another page or URL are listed without a Markdown link.
- **Example:** `https://example.com/about.md`

## Languages

- [English](https://example.com/en/llms.txt): en

## Page Structure

- [Home](https://example.com/): Welcome to our website with all important information. [Markdown](https://example.com/index.html.md)
  - [About](https://example.com/about): Learn about our company history and values. [Markdown](https://example.com/about.md)
  - [Services](https://example.com/services): Professional services for your needs. Keywords: services, consulting, support. [Markdown](https://example.com/services.md)
  - [Contact](https://example.com/contact): Get in touch with us via phone or email. [Markdown](https://example.com/contact.md)
  - [Partner](https://example.com/partner): Our partner for logistics.
```

Each page is one line `- [Title](url): notes` as defined by
[llmstxt.org](https://llmstxt.org/). The notes contain the description,
summary and keywords of the page and the link to its Markdown version, so the
file can be read by llms.txt parsers. Pages of type "Link" and "Shortcut"
only point to another page or URL and have no content of their own, so they
are listed without the Markdown link. The `## Languages` section links to
the llms.txt of the other languages; it is omitted on single-language sites.

With [llmsTxt.enableMarkdown](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-enablemarkdown@main) disabled, the
Markdown hints (including the authentication hints) and the `[Markdown](…)`
links are omitted.

## Accessing Markdown Content {#usage-markdown}

Append `.md` to any page URL to get the content as clean Markdown with
YAML frontmatter.

```text
https://example.com/about.md
```

Pages of type "Link" or "Shortcut" have no content of their own. Their
`.md` URL behaves like the page URL: TYPO3 redirects to the target, or
shows the target page for a "Link" to a page in TYPO3 14.

> [!NOTE]
> The Markdown output is enabled by default. It can be turned off per site
> with [llmsTxt.enableMarkdown](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-enablemarkdown@main), `.md` URLs
> then return a regular 404.

### Example Markdown Output {#usage-markdown-output}

```markdown
---
title: "About Us"
description: "Learn about our company history and values."
language: en
date: 2024-06-15
lastmod: 2026-01-31
canonical: "/about"
format: markdown
generator: "TYPO3 LLMs.txt Extension"
---

# About Us

> Learn about our company history and values.

## Our History

Our company was founded in 1985...

## Our Values

- Quality and reliability
- Fair and transparent prices
- Personal consultation
```

The YAML frontmatter contains:

-   **title**: Page title
-   **description**: Page description (from LLM or SEO settings)
-   **language**: ISO language code
-   **date**: Page creation date (from TYPO3 `crdate`)
-   **lastmod**: Last modification date (most recent change across page and content elements); omitted if same as `date`
-   **canonical**: Canonical URL path
-   **format**: Output format (always "markdown")
-   **generator**: Extension identifier

### Accessing the Root Page {#usage-root-page}

For the root/home page, use:

```text
https://example.com/index.html.md
```

Or simply:

```text
https://example.com/.md
```

## Multi-Language Access {#usage-multi-language}

Every enabled language of a site has its own llms.txt below its base:

```text
# Default language
https://example.com/llms.txt

# English (base /en/)
https://example.com/en/llms.txt

# Language with its own domain
https://example.co.uk/llms.txt
```

Each file lists the pages in its language, with translated titles,
descriptions and URLs. With `fallbackType: strict`, untranslated pages are
left out. The `## Languages` section of each file links to the llms.txt of
the other languages. A language without pages has no llms.txt (404).

The intro comes from the field [llms.txt Intro](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-language-intro@main)
of the language, or for the default language from
[llmsTxt.intro](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-intro@main). The API key
([llmsTxt.apiKey](https://docs.typo3.org/permalink/rtfirst/llms-txt:confval-apikey@main)) protects the llms.txt of every
language.

Access page content in different languages using the language URL prefix
with the `.md` suffix:

```text
# German (default language)
https://example.com/ueber-uns.md

# English
https://example.com/en/about.md

# French
https://example.com/fr/a-propos.md
```

The extension automatically:

-   Detects the language from the URL prefix
-   Loads the translated page content
-   Sets the correct language in the YAML frontmatter

## Caching {#usage-caching}

The extension uses smart caching for optimal performance:

-   **llms.txt**: Cached and regenerated when TYPO3 cache is cleared or the
    `llmsTxt.*` site settings change
-   **Markdown output**: Cached for 24 hours per page/language combination

To force regeneration:

```bash
vendor/bin/typo3 cache:flush
```

Or in DDEV:

```bash
ddev typo3 cache:flush
```

## Content Filtering {#usage-content-filtering}

The Markdown output is automatically cleaned for better LLM consumption:

**Removed elements:**

-   Scripts and styles
-   Navigation and footer elements
-   Sidebar content
-   Bootstrap accessibility spans (`visually-hidden`)
-   Empty anchor tags (`<a id="c1"></a>`)

**Preserved elements:**

-   Main content text
-   Headings and structure
-   Lists and tables
-   Images (converted to Markdown syntax)
-   Links (converted to absolute URLs)