obsidian-vault-management

用途

Obsidian Vault Management 用于创建、编辑和管理 Obsidian 知识库（vault）中的内容，包括笔记、模板、日记笔记（daily notes）和 Dataview 查询。它适用于在 Obsidian 中处理 Markdown 文件的场景。

知识库结构（基于 PARA）

该知识库采用类似 PARA 的组织方式，目录与用途如下：

• 00 - Maps of Content：链接相关主题的索引笔记
• 01 - Projects：进行中的项目笔记
• 02 - Areas：持续性的职责领域
• 03 - Resources：参考资料
• 04 - Permanent：常青 / zettelkasten 笔记
• 05 - Fleeting：快速捕捉笔记
• 06 - Daily：日记笔记（YYYY/MM/YYYYMMDD.md）
• 07 - Archives：已完成 / 不活跃内容
• 08 - books：书籍笔记与摘录
• 99 - Meta：模板、设置
• Clippings：网页剪藏与导入内容

主要能力

链接语法

• [[Note Name]]：基础 wikilink
• [[Note Name|Display Text]]：带别名的链接
• [[Note Name#Heading]]：链接到标题
• [[Note Name#^block-id]]：链接到块
• ![[Note Name]]：嵌入笔记
• ![[image.png]]：嵌入图片
• ![[Note Name#Heading]]：嵌入章节

Frontmatter 模板

---
created: {{date:YYYY-MM-DDTHH:mm}}
updated: {{date:YYYY-MM-DDTHH:mm}}
title: "Note Title"
type: note
status: draft
tags:
  - tag1
  - tag2
aliases:
  - "Alternate Name"
cssclasses:
  - custom-class
---

Callouts

> [!note] Title
> Content

> [!warning] Important
> Warning content

> [!tip] Helpful tip
> Tip content

> [!info]+ Collapsible (open by default)
> Content

> [!danger]- Collapsed by default
> Content

可用的 callout 类型：note、abstract、info、todo、tip、success、question、warning、failure、danger、bug、example、quote。

创建笔记

日记笔记：创建于 06 - Daily/YYYY/MM/，文件名为 YYYYMMDD.md，包含 frontmatter（created、updated、title、type、status、tags、aliases、date_formatted、topics、related、cssclasses）、任务、日志和导航链接。

Zettelkasten 笔记：创建于 04 - Permanent/，包含 created、type、tags 等 frontmatter，以及 Main Insight、Connections、References 等章节。

Dataview 查询

Dataview 查询语法参见 references/dataview.md。快速示例：

LIST FROM "06 - Daily" WHERE file.cday = date(today) SORT file.ctime DESC

TABLE status, tags FROM "01 - Projects" WHERE status != "completed"

模板

模板位置：99 - Meta/00 - Templates/。Templater 语法参见 references/templater.md。

常用 Templater 变量：

• <% tp.file.title %>：当前文件名
• <% tp.date.now("YYYY-MM-DD") %>：当前日期
• <% tp.file.cursor(1) %>：光标位置
• <% tp.system.prompt("Question") %>：用户输入提示

已安装插件

• Dataview：查询并显示笔记中的数据
• Templater：带脚本的高级模板
• Auto Note Mover：按标签自动整理笔记
• Periodic Notes：日记 / 周记 / 月记
• Kanban：Markdown 中的看板
• Tag Wrangler：批量标签管理
• Table Editor：Markdown 表格编辑
• Advanced URI：笔记的深度链接
• Local REST API：外部 API 访问

使用方式

创建笔记时：根据笔记类型确定合适的目录；添加正确的 frontmatter；使用一致的命名约定；包含相关标签以便自动整理。

最佳实践：使用描述性文件名（除连字符外避免特殊字符）；始终包含 created 和 updated 时间戳；为可发现性给笔记打标签；双向链接到相关笔记；使用 callout 标注重要信息；在日记笔记中包含导航链接。

高级功能

• Dataview 查询：references/dataview.md
• Templater 脚本：references/templater.md
• Canvas 图表：references/canvas.md
• 插件配置：references/plugins.md

限制与注意事项

• 在 Obsidian 之外进行批量操作不会触发链接重建——外部脚本必须发出 :Reindex 信号或等待下次打开知识库。
• Dataview 缓存是按知识库和按会话的——如果 Obsidian 上次打开时使用了不同的过滤器，基于 CLI 脚本的 DQL 查询可能看到过期状态。
• 通过 CLI 运行的 Templater 脚本与 UI 上下文不同——许多 tp.system.* 函数返回 nil（没有可供提示的 UI）。
• PARA 目录移动会破坏基于标签的查询——如果查询硬编码了目录路径，请在重组前将其重构为使用标签或属性。
• 日记笔记轮换：在知识库中途更改日记笔记格式会使旧笔记成为孤立内容——它们不会自动迁移到新格式，需要执行一次重命名处理。