Erste Seite
Eine Doku-Seite besteht aus Frontmatter und Markdown – mehr nicht.
Datei anlegen
Jede Seite ist eine Markdown-Datei unter src/content/docs/<sprache>/<bereich>/. Der Dateiname wird zur URL:
src/content/docs/de/start/erste-seite.md → /docs/start/erste-seite/
Frontmatter
---
title: Erste Seite
description: Ein Satz, der auf Karten und in der Suche erscheint.
section: start
order: 2
icon: 📄
---
| Feld | Pflicht | Bedeutung |
|---|---|---|
title | ja | Seitentitel, erscheint im Baum |
description | ja | Untertitel und Suchtext |
section | ja | Bereich aus src/data/docs.ts |
order | nein | Reihenfolge im Bereich |
icon | nein | Emoji als Seiten-Icon |
updated | nein | Datum in der Meta-Zeile |
draft | nein | true blendet die Seite aus |
Inhalt
Überschriften der Ebenen 2 und 3 landen automatisch in der Navigation rechts. Tabellen, Codeblöcke und Zitate übernehmen den Look der Foundation.
Kurze Seiten mit klaren Überschriften werden häufiger gelesen als lange – Atlas belohnt das mit einer Navigation, die jede Überschrift zeigt.
Nächster Schritt
Wie Bereiche und Reihenfolge entstehen, steht unter Projektstruktur.