Markdown与YAML规范

Markdown 与 YAML 规范

摘要：知识库里几乎所有自动化功能（首页统计、领域概览的自动列表、成员档案的项目聚合）都依赖笔记开头的 YAML 属性写得规范。这里整理几个最容易踩坑的地方。

什么是 YAML frontmatter

每篇笔记最开头、用 --- 包裹起来的那一段，就是 YAML 属性区：

---
cssclasses:
  - knowledge-note
tags: [多层次医疗保障, 案例摘要]
领域: 多层次医疗保障
更新时间: 2026-08-11
---

这些属性不会显示在正文里，但 Dataview 查询、Obsidian 的属性面板都是靠读取这里的字段工作的。

tags: [外部报告, 数字医疗, 2026]   ❌ 错误：2026 会被判定为非法标签
tags: [外部报告, 数字医疗, 行业报告]   ✅ 正确

年份信息应该放在专门的字段里（比如 发布时间: 2026），不要塞进 tags。

来源机构: 弗若斯特沙利文（Frost & Sullivan）   ❌ & 在 YAML 里有特殊含义
来源机构: "弗若斯特沙利文（Frost & Sullivan）"   ✅ 加双引号包裹

原文路径: "E:\Download\报告.pdf"       ❌ 反斜杠会被当作转义字符
原文路径: "E:/Download/报告.pdf"       ✅ 用正斜杠

来源项目: [[02_项目档案/研究咨询/某项目]]     ❌ 方括号在 YAML 里会被解析成列表
来源项目: "[[02_项目档案/研究咨询/某项目]]"   ✅ 加引号，Obsidian 仍能正确识别为链接

不需要每次都从零手写这些规则——直接从文档模板库里复制对应类型的模板（项目档案模板、领域概览模板、成员档案模板等），YAML 结构已经是对的，只需要替换里面的具体内容。