First page

Create the file

Every page is a Markdown file under src/content/docs/<language>/<area>/. The file name becomes the URL:

src/content/docs/en/start/erste-seite.md  →  /en/docs/start/erste-seite/

Frontmatter

---
title: First page
description: One sentence that appears on cards and in search.
section: start
order: 2
icon: 📄
---

Field	Required	Meaning
title	yes	Page title, shown in the tree
description	yes	Subtitle and search text
section	yes	Area from src/data/docs.ts
order	no	Position within the area
icon	no	Emoji as page icon
updated	no	Date in the meta line
draft	no	true hides the page

Content

Headings of level 2 and 3 automatically land in the navigation on the right. Tables, code blocks and quotes take on the look of the foundation.

Short pages with clear headings get read more often than long ones – Atlas rewards that with a navigation that shows every heading.

Next step

How areas and their order come together is explained under Project structure.