YAML Front Matter

When Add YAML front matter is enabled, each exported .md file begins with a YAML block containing metadata about that page.

Example Output

---
title: "My Confluence Page"
author: "Jane Smith"
date: 2026-04-08
space: DOCS
confluence_id: "123456789"
project: "Q2 Docs"
reviewed: "true"
---

# My Confluence Page

...page content...

Built-in Fields

The following fields are available out of the box. Each can be individually toggled on or off:

Field Value Example
title Page title "My Confluence Page"
author Display name of the last editor "Jane Smith"
date Date of the last edit 2026-04-08
space Confluence space key DOCS
confluence_id Numeric page ID "123456789"

Fields with no available value are omitted automatically. For example, if the author cannot be resolved, the author line will not appear.

Custom Fields

You can add your own key-value fields to every exported file. This is useful for:

  • Adding a project or team label for downstream tooling
  • Including a reviewed or status flag
  • Tagging exports with a source identifier

Adding a Custom Field

  1. Enable Add YAML front matter in the configuration panel
  2. In the custom fields row under the built-in toggles, type a key (e.g. project) and a value (e.g. Q2 Docs)
  3. Press Enter or click +

The field is added to the list immediately and appears in the live preview.

Removing a Custom Field

Hover over a custom field row and click the × button that appears on the right.

Live Preview

While the front matter section is expanded, a live preview shows exactly what the YAML block will look like based on your current settings:

---
title: "Page title"
author: "Author name"
date: 2026-01-01
space: SPACEKEY
confluence_id: "123"
project: "Q2 Docs"
---

The preview updates instantly as you toggle fields or add/remove custom fields.

Compatibility

The generated YAML front matter is compatible with:

  • Obsidian (parsed as note properties)
  • Hugo, Jekyll, Gatsby, and other static site generators
  • Logseq and other PKM tools that support YAML metadata
  • Any tool that reads standard YAML front matter blocks