> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yamuno.com/llms.txt
> Use this file to discover all available pages before exploring further.

# YAML Front Matter

> Configure YAML metadata fields in your Markdown exports

# YAML Front Matter

When enabled, the exporter prepends a YAML front matter block to every exported `.md` file. This is useful for static site generators (MkDocs, Docusaurus, Jekyll, Hugo), documentation pipelines, and Obsidian.

## Enabling Front Matter

In the exporter panel, toggle **"Include YAML front matter"** to on. A preview of the front matter block appears in the live preview.

## Built-in Fields

The following fields are available and individually toggleable:

| Field           | Example value           | Description                              |
| --------------- | ----------------------- | ---------------------------------------- |
| `title`         | `Architecture Overview` | The Confluence page title                |
| `author`        | `Jane Smith`            | The page's last modifier                 |
| `date`          | `2026-04-23`            | The page's last modified date (ISO 8601) |
| `space`         | `ENG`                   | The Confluence space key                 |
| `confluence_id` | `123456789`             | The Confluence page ID                   |

Toggle any field off to exclude it from the output.

## Custom Fields

Add your own key-value pairs for downstream processing. Click **"+ Add custom field"**, enter a key and a static value, and it will be included in every exported file.

Example use cases:

* `status: draft` — mark all exports as drafts in a CMS
* `product: backend-api` — tag exports for a specific product
* `category: internal` — classify content for a static site

## Example Output

With all built-in fields enabled and two custom fields added:

```yaml theme={null}
---
title: Architecture Overview
author: Jane Smith
date: 2026-04-23
space: ENG
confluence_id: 123456789
status: published
product: platform
---

# Architecture Overview

Your page content starts here...
```

## Front Matter in Static Site Generators

Most static site generators read YAML front matter to build navigation, set page titles, and configure metadata. Common integrations:

* **MkDocs** — uses `title` for nav labels
* **Docusaurus** — reads `title`, `description`, and custom fields
* **Jekyll / Hugo** — any YAML field becomes available as a template variable
* **Obsidian** — displays front matter in the Properties panel