# Documentation for AI agents

Every documentation and blog page is published in both HTML and Markdown. The
HTML contains an alternate link to its Markdown representation.

## Discovery files

- [`/llms.txt`](/llms.txt) is a compact index of available content.
- [`/llms-full.txt`](/llms-full.txt) combines the documentation and blog into one file.
- [`/sitemap.xml`](/sitemap.xml) provides the complete HTML URL inventory.
- [`/openapi.yaml`](/openapi.yaml) describes the public HTTP interface.

## Page-level Markdown

Append `.md` to a page's path. For example:

```text
/docs/concepts/   HTML
/docs/concepts.md Markdown
```

The page context menu also provides **Copy as Markdown** and **View as
Markdown** actions.

## Content guarantees

Documentation and blog sources use portable Markdown without Hugo or Hextra
shortcodes. An automated site check rejects shortcodes in those sections so the
published Markdown remains directly useful outside the website renderer.