笔记同步助手同步文章时，会在 Obsidian 笔记顶部自动写入前置元数据（Front Matter），记录来源、时间、标签等信息。你可以自定义这个模板，调整字段名称、格式或内容。

第一步：找到高级选项

打开 Obsidian 中笔记同步助手插件的设置页面，滚动到底部，点击「高级选项 / advanced」展开高级设置。

不熟悉怎么打开插件设置页：先点 Obsidian 左下角齿轮 ⚙️ 进入 Obsidian 设置，再在左侧菜单向下滚动到「第三方插件」区域，点开「笔记同步助手」。

第二步：填写前置元数据模板

在高级选项中，找到「前置元数据模板 / front matter template」输入框，填写自定义的 YAML 模板。模板中支持使用变量（如 {{author}}、{{siteName}}、{{originalUrl}} 等），同步时会自动替换为实际内容。

进阶示例：用 mapValue 拆开 AI 整理笔记的来源前缀

视频、播客链接经 AI 整理后同步的笔记，来源属性（{{{siteName}}}）是拼接出来的，形如 AI整理 - 某视频平台、AI整理 - 播客——固定前缀「AI整理」加上来源平台名。直接拿整串当属性，按类型筛选笔记时不太方便。

可以用内置的 mapValue 值映射函数，按前缀把它拆成一个干净的分类属性：

title: "{{{title}}}"
author: "{{{author}}}"
来源: "{{{siteName}}}"
笔记类型: "{{#mapValue}}{{{siteName}}}|*播客*=播客整理,*AI整理*=视频转图文,*=网页文章{{/mapValue}}"

渲染效果：

• 来源是 AI整理 - 播客 → 笔记类型: 播客整理

• 来源是 AI整理 - 某视频平台 → 笔记类型: 视频转图文

• 来源是 微信公众号 等普通网页 → 笔记类型: 网页文章

mapValue 的写法是 {{#mapValue}}取值|规则表{{/mapValue}}，规则用逗号分隔：精确值=结果、*包含*=结果（取值里含这个词就命中）、*=兜底。优先级固定为 精确 > 包含 > 兜底 > 原值。包含规则之间按书写顺序判定，所以上面把 *播客* 写在 *AI整理* 前面，播客笔记才会先命中「播客整理」。

这样在 Obsidian 里就能直接按「笔记类型」属性过滤、分组所有同步笔记。mapValue 在前置元数据、文章内容、文件名和各文件夹路径模板里都能用。

推荐：先在调试器里调试好再复制

建议先在在线调试器中调整模板，实时预览渲染效果满意后，再复制到插件设置中。调试器地址：https://obsidian.notebooksyncer.com/template-playground

调试器支持前置元数据、文章内容、文件名等多个模板的预览，可以方便地测试各种变量的效果。