Content Authoring

Docs pages are sourced from src/content/docs/**/*.{md,mdx}.

Required Frontmatter

Every docs file needs this frontmatter shape:

---
title: Your Page Title
order: 1
section: Basics
description: Short page summary
---
  • title: page title and sidebar label
  • order: sort order inside a section
  • section: sidebar group label
  • description (optional): meta description

Add a New Doc Page

  1. Create a file in src/content/docs, for example my-page.mdx.
  2. Add frontmatter fields required by the docs collection schema.
  3. Write Markdown or MDX content.
  4. Visit /docs/my-page locally.

Nested Routes

You can create subfolders and get nested routes:

  • src/content/docs/guides/auth.mdx -> /docs/guides/auth

Copy Markdown Behavior

Each docs page also has a raw markdown endpoint at the same path with .md appended.

Example: /docs/getting-started.md.

This powers the “Copy markdown” action in the docs layout.

dqnamo