Structure
Every .md file in your folder becomes a page. Every subfolder becomes a section.
Folder pages
index.md in any folder becomes that folder's page. moss also recognizes readme.md, _index.md, and main.md (checked in that order, case-insensitive).
A file named after its parent folder also works:
recipes/
├── recipes.md ← folder page (same name as folder)
├── pasta.md
└── soup.md
When a folder has no index.md, moss auto-generates a page that lists its children.
The root index.md is your homepage.
URLs
Each file's path determines its URL:
| File | URL |
|---|---|
index.md | / |
about.md | /about/ |
posts/index.md | /posts/ |
posts/hello.md | /posts/hello/ |
Override with url in frontmatter:
---
title: Hello World
url: /blog/2024/hello/
---
Visibility
| Setting | Built | In lists | In sitemap |
|---|---|---|---|
| (default) | yes | yes | yes |
unlisted: true | yes | no | no |
draft: true | no | no | no |
Prefix a folder with _ to exclude it entirely: _drafts/ is ignored.
Sort order
Children are sorted: subfolders first (alphabetically), then by date (newest first), then alphabetically. Override with weight — lower numbers sort first.
Navigation
Root-level pages appear in header navigation automatically. Control with nav: true/false and weight.