Frontmatter

Every markdown file starts with YAML frontmatter:

---
title: Page Title
date: 2025-01-01
author: Your Name
lead: A short description for listings and previews.
tags:
  - tag1
  - tag2
menu:
  visible: true
  order: 1
template: default
---

Available Fields

Field	Description	Required
`title`	Page title	Yes
`date`	Publication date	No
`author`	Author name	No
`lead`	Short excerpt for listings	No
`tags`	List of tags	No
`menu.visible`	Show in navigation	No
`menu.order`	Sort order in menu	No
`template`	Template to use	No
`process.markdown`	Enable/disable markdown rendering (default: `true`)	No

The process.markdown field is covered in detail under Processing Control.

Using Lead in Templates

The lead field provides a short description that appears in page listings (like the Docs or Blog index). Use it in templates:

{% for p in all_pages %}
  <h3><a href="{{ p.url }}">{{ p.title }}</a></h3>
  {% if p.lead %}<p class="lead">{{ p.lead }}</p>{% endif %}
  {% if p.date %}<time>{{ p.date }}</time>{% endif %}
{% endfor %}