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.
#tagsfound 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.