# Markdown and llms.txt

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

Source: https://www.hey.support/docs/developer-guide/markdown-and-llms

---

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`

```bash
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

| File                                                      | What it holds                                                                                                 |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [`/llms.txt`](https://www.hey.support/llms.txt)           | A short index: what Hey Support is, and a link with a one-line description for every docs page and blog post. |
| [`/llms-full.txt`](https://www.hey.support/llms-full.txt) | Every docs page in full, in one file.                                                                         |
| [`/openapi.json`](https://www.hey.support/openapi.json)   | The public API, as an OpenAPI 3.1 document. The [API reference](/docs/api) 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`.

<NextSteps>
  <IconCard icon="braces" title="API reference" href="/docs/api" description="Base URL, versioning, IDs, pagination and errors." />

  <IconCard icon="webhook" title="Webhooks" href="/docs/developer-guide/webhooks" description="Get events pushed instead of polling." />
</NextSteps>