文章属性与 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 任一满足),可组合关键词与目录范围。填了名字点「创建」保存为动态视图,属性与文件变化后结果自动重算;视图保存在本机,暂不跨设备同步。