Writing
Create content with Markdown and front matter
Content lives in the content/ directory. Write Markdown with TOML (+++), YAML (---), or JSON ({...}) front matter. TOML is the default; YAML is widely recommended; JSON is supported for users who prefer it.
Content Types
| Type | File | URL |
|---|---|---|
| Page | about.md | /about/ |
| Section | blog/_index.md | /blog/ |
| Section Page | blog/post.md | /blog/post/ |
Basic Content File
+++
title = "My Page"
date = "2024-01-15"
+++
Content in **Markdown**.
Where to Start
Start with Pages to learn the basics of content files and front matter. Then read Sections to organize content into groups like a blog or docs. From there:
- Taxonomies — Classify pages by tags, categories, or custom groups
- Shortcodes — Embed reusable components (YouTube, alerts, galleries) inside Markdown
- Archetypes — Define templates for
hwaro newto scaffold content quickly - Front Matter Schema — Require fields per section, with types, enums, bounds and defaults
- Wikilinks & Backlinks — Build Obsidian-style notes with
[[links]], embeds andpage.backlinks
In this section
Pages
Create pages from Markdown with front matter metadata
Sections
Group related content with directory sections
Taxonomies
Organize content with tags, categories, and custom groups
Shortcodes
Reusable template snippets for Markdown content
Archetypes
Content templates for consistent front matter and structure
Front Matter Schema
Declare the front matter each section requires, with types, enums, bounds and defaults
Wikilinks & Backlinks
Build an Obsidian vault or wiki-style notes as is: wikilinks, image embeds, note transclusion, foldable callouts and page.backlinks