metadata for folders, set in index.md inside the folder. controls how the folder displays its contents.
fields
| field | description | values |
|---|---|---|
| default_view | how items are displayed | list (default), cards, grid |
| title | folder title | any string |
| description | folder description | any string |
default_view
set the default display mode when visiting the folder:
---
default_view: grid
---
list- file browser style (default)cards- card layout with image, title, description, datesgrid- thumbnail grid (good for photos)
visitors can still switch views with the toggle button. this just sets the default.
subfolders inherit default_view from root if not set.
example: photo gallery
---
title: Photos
default_view: grid
---
my photo collection.
root folder
the root index.md is special - it also accepts site-wide settings like colors and menus. see customization for those options.
content in index.md
any content after the frontmatter appears above the file listing:
---
title: Blog
default_view: list
---
welcome to my blog. here are my latest posts:
the content renders as markdown above the folder contents.
related
- metadata - overview
- file-metadata - file settings
- customization - colors, menus, typography