Folders

Folders in docs/ become sections of the navigation, nested as deep as your folders go. A folder only appears when it contains at least one page.

#Title, icon and order

A folder describes itself in an index.md inside it, with the same front matter as a page:

---
title: Guides
icon: fa-solid fa-book-open
order: 3
---

Without an index.md, a folder is named after its folder name: getting-started becomes “Getting started”.

#A page for the folder

When index.md has text below its front matter, that text is the folder’s page, shown when readers open the folder at its URL (/guides). An index.md with only front matter just names the folder; its page then lists the pages in it. See index pages.

#Folders in other languages

Translate a folder like a page: index.de.md next to index.md gives the folder its German title and German page.

---
title: Guides
order: 3
---

# Guides

Step-by-step guides for …

---
title: Anleitungen
---

# Anleitungen

Schritt-für-Schritt-Anleitungen für …

The order always comes from the original index.md.