SuperAPI AI 工具集

obsidian-frontmatter

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:管理 Obsidian 笔记顶部的 YAML frontmatter(即 Properties),包括首次正确写入、跨笔记统一 schema、更新过期属性,以及修复导致 Obsidian 报解析错误的畸形 YAML。frontmatter 是笔记可查询的 schema 层,格式不一致会导致 Dataview 查询失败、搜索不完整。

适用时机:为无 frontmatter 的笔记添加属性块;更新单个属性(如状态、标签);跨多篇笔记统一 schema;修复 YAML 解析错误;增删列表属性项(tags、aliases);为会议、项目、日记等笔记类型建立模板;为 Dataview 查询定义属性。不适用于管理正文 wikilink(用 obsidian-links)、创建完整笔记(用 obsidian-note-builder)或非 Obsidian 的 Markdown 文件。

主要能力与规则:开头 --- 必须在第 1 行;列表项用两空格缩进,禁止 Tab;tags 与 aliases 必须为多行列表,不可写成 tags: [a, b];含冒号的字符串需加引号;布尔值小写 true/false;日期用 ISO 8601(YYYY-MM-DD);frontmatter 中的 wikilink 必须加引号,如 project: "[[Project Alpha]]"。标准属性含 title、date、tags、aliases、status,并按笔记类型扩展(会议、项目、参考、日记)。

使用方式:先检查现有笔记状态与错误类型,确定目标 schema,生成完整属性块,替换原 --- 之间的内容并保留其后正文,最后校验格式。批量操作时逐篇应用并输出变更摘要。

限制:不得在未确认时删除已有属性;不得在首个标题后添加 frontmatter;标签在 frontmatter 中不带 # 前缀,层级用 / 表示。具体安装与调用方式资料未提供。