Markdown frontmatter

Every Markdown file exported by Quendian includes a YAML frontmatter block at the top of the file.

Frontmatter fields

Field	Type	Description
session_id	UUID string	Unique identifier for the session
started_at	ISO 8601 datetime	When the recording started. Empty string if unavailable.
stopped_at	ISO 8601 datetime	When the recording was stopped
duration_seconds	Float (2 decimal places)	Total recording duration in seconds
source_note_path	String	Path to the linked note. Only present when a source note is associated.

Example — full frontmatter

---
session_id: 550e8400-e29b-41d4-a716-446655440000
started_at: 2024-03-15T14:30:00Z
stopped_at: 2024-03-15T15:00:12Z
duration_seconds: 1812.47
---

Example — with source note path

---
session_id: 550e8400-e29b-41d4-a716-446655440000
started_at: 2024-03-15T14:30:00Z
stopped_at: 2024-03-15T15:00:12Z
duration_seconds: 1812.47
source_note_path: /Users/you/Notes/Team meeting.md
---

Field notes

started_at — recorded from the moment the user starts the session. In rare cases (for example, a crash recovery) this may be empty.

duration_seconds — always present and formatted to two decimal places (e.g., 1812.47).

source_note_path — this field is omitted entirely when no source note is linked to the session. Do not rely on its presence in parsing logic without a nil/missing check.

Body structure

After the frontmatter, the file contains:

# Session Title

## Transcript
**Speaker:** transcript text here...

## Summary
Summary text here...

If the summary has not been generated yet, the Summary section reads _Pending._.

See Export for the full file format and filename options.

---

Schema sourced from CompletedSessionStore.swift renderMarkdown — audited 2026-05-10.