Mindex

Frontmatter

The YAML block at the top of a note, and what Mindex reads from it.

Frontmatter is optional. A note without it is an untyped note.

---
type: project
status: active
owner: "[[People/Dmitriy]]"
---

type

The only key Mindex treats specially. It names a type — one of the built-in ones, or one of yours from .mindex/types/. A type Mindex does not recognise leaves the note untyped rather than broken.

Everything else

The remaining keys are the type's fields. Which keys a type has, and what kind of value each holds, is defined by the type.

Kind YAML
text owner: Anna
number amount: 1200
date due: 2026-10-01
boolean archived: true
select status: active
relation project: "[[Projects/Redesign]]"
list a YAML sequence

Quote them. YAML reads a bare [[…]] as a nested sequence.

owner: "[[People/Dmitriy]]"
participants:
  - "[[People/Anna]]"
  - "[[People/Ben]]"

Links written this way are real links — backlinks and the graph include them.

Keys Mindex does not know

Left alone. A type never strips a key, and a note is never rejected for having one. Mindex draws what the type describes and preserves the rest.

Invalid YAML

Reported rather than silently discarded. Raw mode is where you fix it.