> [Agent navigation index](/llms.txt)

# Semantic Markdown

Brix exposes explicitly authored semantic Markdown beside selected SSR pages. Page projections, durable representation URLs, and compact navigation indexes are separate workflows.

Start here when agents or other text clients need to read the same useful content as a page's
human visitors. This is an alternate representation of your page, not a separate set of agent
instructions or an automatic HTML-to-Markdown conversion.

First make one page available as Markdown and verify its content. Then add an index so readers
can discover it. Existing HTML URLs and page authorization remain in place.

## Author page representations

[Declare Markdown on a page contract, build safe documents within the builder limits, negotiate and link durable `.md` URLs, and localize projections.](/docs/markdown-pages.md)

## Publish and operate indexes

[Publish scoped and localized `llms.txt` indexes, keep index and page auth aligned, cache representations at the edge, and test both renderers.](/docs/markdown-indexes.md)
