Article Properties & Frontmatter

2026-11-15

Each document's YAML frontmatter is its property card: status, summary, tags and custom properties live there, powering property filters and dynamic views. The "Properties" button at the top of the editor opens the panel; changes save themselves.

The panel

  • Read-only system info with a lock icon — title, id, revision — plus the three fixed properties: status, summary, tags;
  • Changes save about half a second after typing stops, with the save status on top; closing the panel, switching documents and quitting the app all wait for the save;
  • Failed saves keep your edits — click "Retry save"; on a concurrent-edit conflict you get a prompt, and unsaved edits are never lost.

Fixed properties

  • Status: draft / serializing / finished — pick one;
  • Summary: a blurb quoted directly by cards and lists;
  • Tags: Enter or comma turns input into tag chips; the × removes one. #tags found in the body plus AI-applied tags are listed separately under "recognized tags", each clickable back to its spot.

Custom properties

"Add property": name it, pick a type, set a value, confirm with the checkmark. A property's type icon opens rename / retype / delete.

  • Four types: text, number, date, boolean; property names accept Chinese;
  • Unconfirmed rows never reach the file;
  • Names colliding with system fields (id, revision, tags…) are refused at save.

What is frontmatter?

Properties are written straight into the document's YAML frontmatter — the block between two --- lines at the top of the file. Open the .md in any editor and it's there, hand-editable as long as it stays valid YAML. Broken YAML blocks property writes; fix it first, then use the panel again. The body and annotations live outside the frontmatter and are unaffected.

Searching by property

Ctrl+Shift+T global search takes property conditions; multiple conditions default to AND:

Condition Meaning
tag:人物 the tag and its children
status:draft drafts
prop.project:雾城 custom property equals a value
prop.project:"雾 城" quote values containing spaces
words:>=3000 at least 3000 words
updated:<-30d modified more than 30 days ago
has:prop.source the property exists

Comparisons = != > >= < <= are supported; dates accept YYYY-MM-DD, today, this-week and relative days. Plain keywords also hit property values. A property hit opens the properties panel; a body hit keeps locating in the text — see Global Search.

Dynamic views

The funnel icon at the top of "All documents" opens the view dialog: add filter rows (AND / OR) and combine keywords with folder scopes. Name it and click "Create" to save a dynamic view — results recompute as properties and files change. Views are stored locally; cross-device sync is not available yet.