Markdown and llms.txt

Every docs page is available as Markdown, and the whole site has an index for AI agents and crawlers.

These docs are written for people and for agents. Every page has a Markdown form, and two index files describe the site.

One page as Markdown

Two ways, same result:

  • add .md to any docs URL: https://www.hey.support/docs/knowledge/website.md
  • request the page with Accept: text/markdown
curl -H "Accept: text/markdown" https://www.hey.support/docs/knowledge/website

The Markdown is the page's real source, embedded at build time, so it cannot drift from what you see in the browser. Copy page at the top of every page copies the same text.

The whole site

FileWhat it holds
/llms.txtA short index: what Hey Support is, and a link with a one-line description for every docs page and blog post.
/llms-full.txtEvery docs page in full, in one file.
/openapi.jsonThe public API, as an OpenAPI 3.1 document. The API reference is generated from it.

Point an agent at the docs

Give a coding or support agent https://www.hey.support/llms.txt and it can find the page it needs and fetch it as Markdown. For API work, give it /openapi.json.

Next steps