AI-Friendly Output#

Documentation is increasingly read by tools and agents, not just people. Kiln generates machine-friendly output alongside the HTML, following the llmstxt.org convention.

What’s generated#

File	Contents
`llms.txt`	An index: the site title, summary, and a curated list of page links (grouped by section).
`llms-full.txt`	The full corpus — every page’s markdown concatenated, with source markers.
`…/index.md`	A raw-markdown copy of every page, sitting next to its `index.html`.

Translations#

When a version has more than one language, each language gets its own llms.txt index (the default language’s at the root, others under /<locale>/, e.g. /de/llms.txt). Every index ends with a Translations section linking to the other languages’ llms.txt:

## Translations

- [Deutsch](https://kiln.brokenhands.io/de/llms.txt)

The llms.txt convention only standardises the single root /llms.txt, so this is a best-effort discovery hook: a tool that reads the canonical index can follow the links to the localised ones. The full corpus (llms-full.txt) is emitted for the default language only, to avoid duplicating mostly-fallback content for every locale.

Per-page markdown alternate#

Every HTML page advertises its markdown twin so tools can discover it:

<link rel="alternate" type="text/markdown" href="/guides/llms.md">

So an agent can fetch the clean markdown source of any page by swapping the URL, without scraping HTML.

Example#

llms.txt looks like this:

# Kiln

> Kiln is a documentation-site generator written in Swift.

## Getting Started

- [Installation](https://kiln.brokenhands.io/getting-started/installation/index.md)
- [Quick Start](https://kiln.brokenhands.io/getting-started/quick-start/index.md)

## Guides

- [Configuration](https://kiln.brokenhands.io/guides/configuration/index.md)

Toggling it#

AI output is on by default. Turn it off with:

KilnSite(name: "My Docs", url: "https://example.com", llmsText: false) { … }

Note

The index uses your navigation structure and the site description, so the better organised your nav and the clearer your description, the more useful llms.txt is.