# Authoring Markdown

Write content as plain .md files under src/docs/content/<locale>/.

# Frontmatter

Every page should declare metadata:

---
title: Authoring Markdown
description: Basic writing rules for docs pages.
group: Start Here
order: 2
slug: authoring
---

# Headings

Use normal Markdown headings. They become anchor targets automatically.

# Nested sections

Third-level headings appear in the right-side page outline.

# Internal links

Link to another doc page with a normal path:

[Media](/docs/media)

Inside the app, these links are intercepted and routed without a page refresh.

# Raw HTML

When Markdown alone is not enough, you can inline HTML.

# Code blocks

const route = '/docs/authoring#code-blocks'
console.log(`Open ${route} to land on this section.`)