Quartz Front Matter 速查表

相关概念：Tag、Alias

推荐 ✅

字段	类型	作用	推荐程度	示例
`tags`	`string[]`	标签分类	⭐⭐⭐⭐⭐	`tags: [docker, spring]`
`draft`	`boolean`	是否作为草稿，不发布	⭐⭐⭐⭐	`draft: true`
`aliases`	`string[]`	当前笔记的别名（同义词、简称、历史名称）	⭐⭐	`aliases: [Postgres, PG]`

tags 用于分类，aliases 用于当前笔记的别名。

不推荐 ❌

目前不准备使用：

publish
created
updated
author
series
cover
icon
keywords

原因：

大多数信息可由 Git 获取。
分类应通过 Tag 完成。
保持 Front Matter 尽量精简，降低维护成本。

其它 📦

可选

字段	类型	说明
`title`	`string`	页面标题。不使用时默认采用文件名。
`description`	`string`	页面描述，可用于 SEO 或社交分享。
`cssclasses`	`string[]`	Obsidian 自定义 CSS 类。
`publishDate`	`date`	发布日期（需要主题支持）。
`modified`	`date`	手动指定更新时间（通常不建议）。

Obsidian 常见字段

Quartz 会保留这些字段，但是否产生效果取决于插件或配置。

字段	用途
`created`	创建时间
`updated`	更新时间
`status`	笔记状态
`source`	来源
`author`	作者
`url`	原文链接

我的规范 🧭

默认模板

---
tags: []
---

草稿

---
tags:
  - docker
draft: true
---

使用别名

---
tags:
  - 数据库(database)
aliases:
  - Postgres
  - PG
---

tags 的含义与使用边界：Tag
aliases 的含义与使用边界：Alias

原则：

tags 用于分类
aliases 用于当前笔记的别名
不要把正文中的概念误写成 aliases

Front Matter 用来描述当前笔记，而不是增加维护负担。

优先级：

文件名（标准名称）
Tag（分类）
Backlinks（反向引用）
Graph（知识网络）

尽量避免为了元数据而维护元数据。