用途:该技能面向使用 Obsidian 构建本地优先、纯文本 Markdown 知识库的场景,帮助整理笔记元数据、编写动态查询、设计可视化画布,并用 Git 管理版本与团队协作。
主要能力:
- YAML frontmatter 结构设计,如 id、title、tags、attendees、status、created 等字段,用于可靠检索。
- Dataview 查询语言(DQL),例如 TABLE status, created, attendees FROM #meeting WHERE status != "done" SORT created DESC,可生成动态索引、项目看板与元数据表格。
- DataviewJS 高级可视化,用 JavaScript 遍历笔记、分组任务并渲染表格或任务列表。
- Canvas 工作流,用 .canvas 文件绘制分布式系统架构与数据库结构图。
- Git 版本化同步,将 vault 初始化为 Git 仓库并推送到远端,配合 .gitignore 忽略 .obsidian/workspace.json、.trash/ 等文件。
使用方式:在笔记顶部写 YAML frontmatter,在代码块中写 DQL 或 DataviewJS;同步可手动执行 git init、git remote add、git add、git commit、git push,或使用 Obsidian Git 社区插件与 cron 脚本自动备份。
适用场景:个人 wiki、工程 runbook 与架构笔记、ADR 记录、跨设备同步的 Markdown 仓库。
限制与注意:避免依赖会改写原始 Markdown 的专有插件;不要把大体积二进制文件放入 Git 仓库,建议存对象存储后链接;不要建立过深目录,优先原子笔记与双向链接。Dataview 报错多因字段语法不匹配,可用 p.category ?? "None" 做防御性检查;重命名笔记应在 Obsidian 内进行以自动更新链接;同步冲突常因提交了 workspace 缓存文件,应将其加入 .gitignore。具体收费、平台与效果资料暂未提供。