Skip to content
Project Name
HomeToolsDocs

Add Content

Organize your documentation with collections, frontmatter, and reusable components.

Create new pages

Section titled “Create new pages”

Add Markdown or MDX files under src/content/docs/. Each file should include frontmatter with a title and optional description.

---
title: Release Notes
description: Track high level changes across versions.
---


Write your content here.

Starlight automatically generates a page at /docs/release-notes/ based on this file name.

Control the sidebar

Section titled “Control the sidebar”

The sidebar order is defined in astro.config.mjs. Reference each file’s slug (file name without the extension). For nested navigation, group items using labeled objects.

sidebar: [
  "", // index page
  {
    label: "Guides",
    items: ["install", "configuration"],
  },
];

When you add or rename docs, update the sidebar to keep navigation consistent.

Reuse components in MDX

Section titled “Reuse components in MDX”

You can import Astro or React components inside MDX files to build richer examples.

import Tip from "../../components/Tip.astro";


<Tip title="Heads up">Remember to regenerate API keys after rotating secrets.</Tip>

Add your custom components under src/components/ and reference them with a relative path from the document.

Manage assets

Section titled “Manage assets”

Store screenshots or diagrams in src/assets/ and reference them with relative links. For large media files, consider hosting them on a CDN and embedding the remote URL to keep the repo lightweight.