# Writing

Everything about the content of a page: Markdown, code blocks, alerts, links, images and HTML.

Every page is a Markdown file in `docs/`. Clay supports the Markdown you know from GitHub, adds syntax highlighting and callouts, and checks your links on every build.

| If you want to … | Read |
|------------------|------|
| Know how a file becomes a page and where its title comes from | [Pages](https://clay-doc.github.io/clay-example-repo/3.x/writing/pages.md) |
| Look up headings, lists, tables and task lists | [Markdown](https://clay-doc.github.io/clay-example-repo/3.x/writing/markdown.md) |
| Show code with highlighting, diffs and a copy button | [Code Blocks](https://clay-doc.github.io/clay-example-repo/3.x/writing/code-blocks.md) |
| Add a note, tip or warning | [Alerts](https://clay-doc.github.io/clay-example-repo/3.x/writing/alerts.md) |
| Link to other pages and sections, or add images | [Links & Images](https://clay-doc.github.io/clay-example-repo/3.x/writing/links-and-images.md) |
| Use HTML where Markdown is not enough | [HTML](https://clay-doc.github.io/clay-example-repo/3.x/writing/html.md) |

## Key ideas

- **One file, one page.** `docs/guides/setup.md` becomes `/guides/setup`.
- **Links work like on GitHub.** Link to the `.md` file; Clay turns it into the page's URL and reports links that lead nowhere.
- **Files next to your pages are published.** Images and downloads in `docs/` keep their relative paths.

---

All pages of these docs, as Markdown for language models: https://clay-doc.github.io/clay-example-repo/3.x/llms.txt