Micron Document
███╗ ██╗███╗ ██╗ ██████╗███╗ ███╗███████╗ ███████╗████████╗ █████╗ ██████╗ ████████╗███████╗██████╗
████╗ ██║████╗ ██║ ██╔════╝████╗ ████║██╔════╝ ██╔════╝╚══██╔══╝██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗
██╔██╗ ██║██╔██╗ ██║ ██║ ██╔████╔██║███████╗ ███████╗ ██║ ███████║██████╔╝ ██║ █████╗ ██████╔╝
██║╚██╗██║██║╚██╗██║ ██║ ██║╚██╔╝██║╚════██║ ╚════██║ ██║ ██╔══██║██╔══██╗ ██║ ██╔══╝ ██╔══██╗
██║ ╚████║██║ ╚████║ ╚██████╗██║ ╚═╝ ██║███████║ ███████║ ██║ ██║ ██║██║ ██║ ██║ ███████╗██║ ██║
╚═╝ ╚═══╝╚═╝ ╚═══╝ ╚═════╝╚═╝ ╚═╝╚══════╝ ╚══════╝ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═╝ ╚══════╝╚═╝ ╚═╝

This page is a practical quick-start for creating and publishing new content pages in this project.

Quick start in 5 steps

1. Create a new Markdown file under /content
2. Add frontmatter (title, slug, route, summary, template)
3. Write your page body in Markdown
4. Add optional directives for dynamic sections
5. Add the page to system/config/navigation.yaml

If you only remember one thing: content is authored in Markdown, then rendered through templates into Micron output.

1. Create a content file

Create a file in the content tree, for example:

content/getting-started.md

Use subfolders when it helps structure docs, e.g. content/guides/getting-started.md.

2. Add frontmatter

Add frontmatter to set a template, a page title, a slug and other values required by your page type.

Use this as a base:

md
---
template: default
title: Getting Started
slug: getting-started
route: content/getting-started.mu
summary: First steps for using this starter.
---

Field notes:

- template: page layout (default, landing, minimal, post)
- title: displayed page title
- slug: logical page id
- route: resulting NomadNet route
- summary: short description shown in some templates/lists


3. Write the page body in Markdown

You can use headings, lists, links, code blocks, blockquotes, and images.

md
## What this page covers
- Basic setup
- First post
- Next steps

Read the Markdown guide for supported syntax details.

4. Add directives when needed

Directives are optional line-based commands for dynamic behavior.

Examples:

md
::page_list section=blog limit=5::

md
::app name=chat::

md
::comments::

5. Publish it in navigation

Add your page in system/config/navigation.yaml.

Example top-level entry:

yaml
items:
- label: Introduction
path: /page/index.mu
- label: Getting Started
path: /page/content/getting-started.mu

Example nested section:

yaml
items:
- label: Creating Content
path: /page/content/creating-content.mu
items:
- label: Markdown
path: /page/content/markdown.mu
- label: Templates
path: /page/content/templates.mu
- label: Directives
path: /page/content/directives.mu

Navigation order follows the order in the YAML file.




NomadNet CMS Starter - A reusable NomadNet site starter built from Markdown and Micron.

Page last updated 03/06/2026 13:36