Filename Patterns

The Filename Pattern setting controls what each exported .md file is named. You can use a combination of plain text and tokens.

Available Tokens

Token Replaced with Example output
{title} Slugified page title my-page-title
{date} Last-edited date (YYYY-MM-DD) 2026-04-08
{id} Confluence page ID 75595802

Tokens are replaced at export time using the data for each individual page — so every file in a multi-page export gets its own unique filename.

Examples

Pattern Example filename
{title} (default) my-confluence-page.md
{title}-{date} my-confluence-page-2026-04-08.md
{date}-{title} 2026-04-08-my-confluence-page.md
{id}-{title} 75595802-my-confluence-page.md
export-{title} export-my-confluence-page.md

Quick Insert Buttons

Below the pattern input, there are three token buttons — click any to append that token to the current pattern:

{title} · {date} · {id}

Filename Preview

Each page in the tree shows a live preview of its generated filename directly below the page title — for example my-page-2026-04-08.md. This updates as you type in the pattern field so you can see the exact output before exporting.

Validation

The pattern must include at least one of {title} or {id} to guarantee every file in a multi-page export gets a unique name. Using only {date} or plain text would cause all files to have the same name and overwrite each other in the ZIP.

If the pattern is missing a uniqueness token, the input border turns red and an error message is shown. The Export Selected button is disabled until the pattern is valid.

An empty pattern is also valid — it falls back to {title} automatically.

Slugification

The {title} token converts the Confluence page title to a URL-friendly slug:

  • Spaces become hyphens
  • Special characters are removed
  • The result is lowercase

For example, "Block Quotes & Dividers!" becomes block-quotes-dividers.