Markdown frontmatter

A page begins with a YAML object between --- lines. Fields below are parsed by the actual sitegen deserializer. Unknown metadata (including doc_id) is tolerated, but unknown layouts fail strict builds.

Full configuration

Settings

FieldAccepted typeRequiredDefaultDescription
analyticsboolean | nullnonullSet false to exclude this page from analytics, independently of navigation. True never enables analytics when the site or build has disabled it.
datestring | nullnonullPublication date (ISO 8601, e.g. "2024-06-15").
hiddenbooleannofalseIf true, page renders but does not appear in navigation.
imagestring | nullnonullImage URL for blog card hero image.
layoutstringno"default"
sectionstring | nullnonullNavigation section for grouping (e.g., "About", "Blog").
slugstring | nullnonullURL slug override. If absent, derived from filename.
summarystring | nullnonullShort summary for blog card display.
titlestringno""
weightintegerno100Sort weight for content pages (lower = higher in nav). Default: 100 Constraints: format="int32".

In ordinary sites the default layout is default; documentation mode selects the documentation layout for pages without an explicit layout. weight orders navigation (lower first). hidden hides an entry from navigation/RSS, not from published HTML. Never use it to protect private content.

slug overrides the filename-derived output path. In documentation mode the source-relative nested path is preserved by default. Keep output assignments unique. Headings receive unique lowercase IDs with numeric suffixes for duplicates; link to the generated ID, not a separately maintained anchor.

section: Blog and an ISO date such as "2024-06-15" make a visible page eligible for the default RSS feed. summary and image supply blog cards. See the blog package for asserted ordering/exclusion.