A first page

Where pages live

Every page is a file of the version folder. Its place gives its address:

• docs/v1.0

  • index.mdx — the home page
  • guide

    • index.md — /guide/
    • 01-hello.md — /guide/hello/

The sorting prefixTwo digits and a dash at the start of a name: they order the menu and disappear from the address. sets the order without showing in the URL.

Your turn

Create docs/v1.0/guide/01-hello.md:

---
title: Hello
description: My very first page.
tags: [hello]
---

Welcome to my documentation.

The frontmatterThe block between the two lines of dashes, at the top of the file. is optional, but it is what fills the title of the tab, the menu entry, and the tags below the page.

Check yourself