文章属性与 Frontmatter
2026-11-11
每篇文稿的 YAML Frontmatter 就是它的属性卡:状态、摘要、标签与自定义属性都写在这里,属性筛选与动态视图都靠它们。编辑器顶部的「属性」按钮打开属性面板,改动不需要手动保存。
属性面板
- 面板列出标题、ID、修订号等只读系统信息(带锁图标),以及状态、摘要、标签三个固定属性;
- 停止输入约半秒自动保存,顶部显示保存状态;关闭面板、切换文章或退出应用前都会等待保存完成;
- 保存失败时保留你的编辑,点「重试保存」即可;并发修改冲突时会提示,未保存的编辑不会丢。
固定属性
- 状态:草稿 / 连载中 / 完稿,三选一;
- 摘要:一段简介,卡片与列表直接引用;
- 标签:输入后按 Enter 或逗号确认成小标签块,点 × 移除;正文里
#标签与 AI 打的标签在「识别标签」里单独列出,点击可跳回正文位置。
自定义属性
点「添加属性」,填属性名、选类型、设值,点勾号确认;点已有属性的类型图标可以改名、改类型或删除。
- 类型四种:文本、数字、日期、布尔;属性名允许中文;
- 未确认的添加行不会写入文件;
- 属性名与系统字段(
id、revision、tags等)重名时不允许保存。
Frontmatter 是什么
属性直接写入文稿头部的 YAML Frontmatter——文件开头两条 --- 之间的一段。用其它编辑器打开 .md 也能看到并手工修改,保持合法 YAML 即可。手动改坏了 YAML 会阻止属性写入,先修好再回来改属性;正文与批注不在 Frontmatter 里,不受属性面板影响。
用属性检索
Ctrl+Shift+T 全局检索支持属性条件,多个条件默认同时满足:
| 条件 | 含义 |
|---|---|
tag:人物 |
该标签及其子标签 |
status:draft |
草稿 |
prop.project:雾城 |
自定义属性等于指定值 |
prop.project:"雾 城" |
属性值含空格时加引号 |
words:>=3000 |
字数不少于 3000 |
updated:<-30d |
修改时间早于 30 天前 |
has:prop.source |
属性存在 |
支持 = != > >= < <= 比较;日期支持 YYYY-MM-DD、today、this-week 与相对天数。普通关键词同样能命中属性值;属性命中打开属性面板,正文命中继续定位正文,见「全局检索」。
动态视图
「全部文稿」顶部的漏斗图标打开视图弹框:逐行添加筛选条件(AND 同时满足 / OR 任一满足),可组合关键词与目录范围。填了名字点「创建」保存为动态视图,属性与文件变化后结果自动重算;视图保存在本机,暂不跨设备同步。