# Schreiben

Alles rund um den Inhalt einer Seite: Markdown, Codeblöcke, Hinweise, Links, Bilder und HTML.

Jede Seite ist eine Markdown-Datei in `docs/`. Clay versteht das Markdown, das du von GitHub kennst, ergänzt Syntaxhervorhebung und Hinweisboxen und prüft bei jedem Build deine Links.

| Wenn du … willst | Lies |
|------------------|------|
| Wissen, wie aus einer Datei eine Seite wird und woher ihr Titel kommt | [Seiten](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/pages.md) |
| Überschriften, Listen, Tabellen und Aufgabenlisten nachschlagen | [Markdown](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/markdown.md) |
| Code mit Hervorhebung, Diffs und Kopierknopf zeigen | [Codeblöcke](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/code-blocks.md) |
| Eine Notiz, einen Tipp oder eine Warnung einfügen | [Hinweise](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/alerts.md) |
| Auf andere Seiten und Abschnitte verlinken oder Bilder einfügen | [Links & Bilder](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/links-and-images.md) |
| HTML nutzen, wo Markdown nicht reicht | [HTML](https://clay-doc.github.io/clay-example-repo/3.x/de/writing/html.md) |

## Das Wichtigste

- **Eine Datei, eine Seite.** Aus `docs/guides/setup.md` wird `/guides/setup`.
- **Links funktionieren wie auf GitHub.** Verlinke die `.md`-Datei; Clay macht daraus die URL der Seite und meldet Links, die ins Leere führen.
- **Dateien neben deinen Seiten werden mitveröffentlicht.** Bilder und Downloads in `docs/` behalten ihre relativen Pfade.

---

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