mds

Frontmatter is a YAML block at the top of a doc, between a pair of --- fences. Keys not listed here are ignored.

title¶⎘

---
title: Q3 planning notes
---

When set, this overrides the title that would otherwise be derived from the first # heading in the body. Useful when the heading text is long or when there is no # heading at all.

kind: slides¶⎘

---
kind: slides
---

Switches the doc into slides mode. In slides mode the body is split at --- separators and each slice is presented as a slide. See Markdown for the full slides syntax.

mds.doc_id¶⎘

---
mds:
  doc_id:
    my-workspace: 01HZ3K7QPVR0S4MBXTYNW5GEEF
---

A map from workspace slug to the stable ULID that identifies this doc in that workspace. The CLI writes this map when you run mds push or mds pull--do not edit it by hand.

mds.last_synced¶⎘

---
mds:
  last_synced:
    my-workspace: "2025-11-04T18:32:00Z"
---

Per-workspace timestamp of the last successful sync. Written by the CLI alongside mds.doc_id--do not edit it by hand.

mds.on_check¶⎘

---
mds:
  on_check: hide
---

Controls what happens to task-list items once they are checked. Four values:

• keep (default): checked items stay where they are in the rendered output and in the source.
• hide: render-only. The source is unchanged; checked items are dropped from the rendered view, leaving only uncompleted work.
• remove: on save, checked items are deleted from the source.
• move: on save, checked items are relocated to a sibling ## Done section at the same heading depth. One is created if absent.

keep and hide never touch the source. remove and move rewrite the file on every save, so the change shows up in the doc's version history. Lists already inside a Done section are left alone under any mode, so the trail of completed items doesn't get reprocessed.