obsidian-vault-management

Obsidian Vault 管理

Vault 结构（基于 PARA）

此 vault 采用类似 PARA 的组织方式：

文件夹	用途
00 - Maps of Content	链接相关主题的索引笔记
01 - Projects	活跃项目笔记
02 - Areas	持续性职责
03 - Resources	参考资料
04 - Permanent	常青笔记／卡片盒笔记
05 - Fleeting	快速记录笔记
06 - Daily	每日笔记（YYYY/MM/YYYYMMDD.md）
07 - Archives	已完成／不活跃的内容
08 - books	读书笔记和摘录
99 - Meta	模板、设置
Clippings	网页剪藏和导入内容

快速参考

链接语法

[[Note Name]]                    # Basic wikilink
[[Note Name|Display Text]]       # Aliased link
[[Note Name#Heading]]            # Link to heading
[[Note Name#^block-id]]          # Link to block
![[Note Name]]                   # Embed note
![[image.png]]                   # Embed image
![[Note Name#Heading]]           # Embed section

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
---

Callout

> [!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：

---
created: 2025-12-09T09:00
updated: 2025-12-09T09:00
title: "20251209"
type: daily-note
status: true
tags:
  - daily
  - journal
  - 2025
  - 2025-12
aliases:
  - "2025-12-09"
date_formatted: 2025-12-09
topics:
  - "[[daily]]"
  - "[[journal]]"
related:
  - "[[2025-12-08]]"
  - "[[2025-12-10]]"
cssclasses:
  - daily
---

# Daily Note - 2025-12-09

### Tasks
- [ ] Task 1

### Journal
...

### Navigation
<< [[2025-12-08]] | **Today** | [[2025-12-10]] >>

卡片盒笔记

在 04 - Permanent/ 中创建：

---
created: {{date}}
type: zettelkasten
tags:
  - permanent
  - topic
---

# Note Title

## Main Insight
**Key Idea**: [Main point]

## Connections
- [[Related Note 1]]
- [[Related Note 2]]

## References
- Source citation

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 %>              # Current file name
<% tp.date.now("YYYY-MM-DD") %>  # Current date
<% tp.file.cursor(1) %>          # Cursor position
<% tp.system.prompt("Question") %> # User input prompt

已安装的插件

插件	用途
Dataview	查询和显示笔记中的数据
Templater	支持脚本的高级模板
Auto Note Mover	按标签自动整理笔记
Periodic Notes	每日／每周／每月笔记
Kanban	Markdown 看板
Tag Wrangler	批量管理标签
Table Editor	编辑 Markdown 表格
Advanced URI	指向笔记的深层链接
Local REST API	外部 API 访问

文件操作

创建笔记

1. 根据笔记类型确定合适的文件夹
2. 添加合适的 frontmatter
3. 使用一致的命名规范
4. 添加相关标签以便自动整理

最佳实践

• 使用描述性文件名（除连字符外，避免使用特殊字符）
• 始终包含 created 和 updated 时间戳
• 为笔记添加标签，便于发现
• 双向链接相关笔记
• 使用 callout 标注重要信息
• 在每日笔记中添加导航链接

高级功能

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

---

注意事项

• 在 Obsidian 外进行批量操作不会触发链接重建——外部脚本必须发送 :Reindex 信号，或等待下次打开 vault。
• Dataview 缓存按 vault 和会话分别保存——如果 Obsidian 上次关闭时使用了不同的筛选条件，基于 CLI 脚本的 DQL 查询可能会读取到过期状态。
• 通过 CLI 运行的 Templater 脚本与 UI 中的运行环境不同——许多 tp.system.* 函数会返回 nil（没有可供提示的 UI）。
• PARA 文件夹移动会破坏基于标签的查询——如果查询中写死了文件夹路径，请在重新整理前将其改为使用标签或属性。
• 每日笔记轮换：在 vault 使用过程中更改每日笔记格式会使旧笔记成为孤立笔记——这些笔记不会自动迁移到新格式；需要批量重命名。