Skip to content
Kubernetes Template

Write Your First Doc

This tutorial walks you through creating your first documentation page.

What you’ll build

Section titled “What you’ll build”

A new documentation page with a title, description, and formatted content that appears in the sidebar navigation.

Step 1: Create the file

Section titled “Step 1: Create the file”

Create a new file at src/content/docs/guides/my-first-guide.mdx:

---
title: "My First Guide"
description: "A short guide demonstrating basic MDX authoring."
---


Welcome to your first guide.

Step 2: Add content

Section titled “Step 2: Add content”

MDX supports standard Markdown plus JSX components:

## Section heading


Regular paragraph text with **bold** and _italic_ formatting.


- Bullet lists
- Work as expected


> [!NOTE]
> GitHub-style alerts render as styled callouts.

Step 3: Preview

Section titled “Step 3: Preview”

Run the dev server if it isn’t already running:

Terminal window
bun run dev

Navigate to http://localhost:4321/guides/my-first-guide/ to see your page.

Next steps

Section titled “Next steps”