Getting started

This wiki is an Astro site using the Starlight docs theme. Cloudflare builds and publishes it every time something lands on main.

Adding a page

Create a Markdown file anywhere under src/content/docs/. The file path becomes the URL, and the frontmatter title becomes the page heading and sidebar entry.

---
title: My new page
description: A one-line summary used for search results and link previews.
---

Content goes here.

src/content/docs/guides/my-new-page.md is served at /guides/my-new-page/.

Both sections are autogenerated from their directory, so new files appear without touching any config. Within a section, pages sort alphabetically unless you give them an explicit order:

---
title: My new page
sidebar:
  order: 2
---

Adding a new section

Sections are declared in astro.config.mjs. To add one, create the directory and register it:

sidebar: [
  { label: 'Guides', items: [{ autogenerate: { directory: 'guides' } }] },
  { label: 'Reference', items: [{ autogenerate: { directory: 'reference' } }] },
  { label: 'Runbooks', items: [{ autogenerate: { directory: 'runbooks' } }] },
],

A section with no matching directory will break the build, so create the folder with at least one page in the same commit.

Useful syntax

Starlight adds a few things on top of standard Markdown. Callouts use triple colons:

Code blocks support highlighting and titles:

starlight({
  title: 'Fullstack League',
});

See Authoring Content for the rest.