metadata

configure pages and folders using YAML frontmatter at the top of markdown files.

what is frontmatter

a YAML block between --- markers at the very top of a file:

---
title: My Page
date: 2026-01-01
---

Content starts here.

two types of metadata

file metadata

set on individual .md files - title, date, tags, description.

---
title: My Blog Post
date: 2026-01-01
tags: blog, updates
---

see file-metadata for all options.

folder metadata

set in index.md inside a folder - controls how the folder displays its contents.

---
default_view: grid
sort_by: date
---

see folder-metadata for all options.

inheritance

metadata cascades from site root down to subfolders:

/ (root index.md)
  colors, menus, site settings
    ↓ inherited by
/photos/ (photos/index.md)
  can override default_view, add folder-specific settings
    ↓ inherited by
/photos/summer.md
  can override title, add tags

child settings override parent settings. objects like color are deep-merged (child keys override, parent keys preserved).

related

• file-metadata - page-level settings
• folder-metadata - folder display settings
• customization - colors, menus, typography