Skip to content

Properties and Today's note

Properties are the frontmatter block at the top of a note — the lines between two ---:

---
title: Garden plan
status: draft
tags: [garden, spring]
---
# Garden plan

mdai shows this block as Properties above the note, one row per key. Click Properties to fold it away or open it again. A note without frontmatter, or with an empty one, shows no block.

The same keys are also in the Properties panel: type properties in the command palette (⇧⌘P / Ctrl+Shift+P) and choose Toggle Properties Panel.

Click a value, change it and press Enter; Escape puts the old value back. Only that line changes in the file — changing draft to ready above rewrites status: draft and nothing else.

Only a value on a single line can be edited. A list, such as tags: [garden, spring], is shown but cannot be edited — in the block, tags and aliases appear as small labels. Edit lists in the file.

If the frontmatter is not valid YAML, the block and the panel show it as plain text, read-only. The panel also says so: “This frontmatter is not a list of YAML keys — shown read-only, the file stays unchanged.” A note without frontmatter shows “This document has no properties (frontmatter).”

Type today in the command palette and choose Open Today’s Note. mdai opens a note named with today’s date, such as 2026-09-30.md, and creates it first if it does not exist yet. The date is your computer’s local date.

Running it again the same day opens the same note. It never overwrites what you have written.

Both are set in Settings, as paths inside the vault:

Setting Example Meaning
Daily notes folder daily Where the notes go. Empty means the top of the vault.
Daily note template templates/daily The note a new daily note starts from.

In the template, {{date}} becomes today’s date. With this template:

# {{date}}
## Notes

today’s note starts as:

# 2026-09-30
## Notes