TaskNotes 插件使用指南
TaskNotes 是 Obsidian 中用于为任务创建独立笔记页面的插件,实现任务与笔记的双向关联,让任务管理更加结构化和深度化。
插件特点
| 特性 | 说明 |
|---|---|
| 📝 任务笔记 | 为每个任务创建独立的笔记页面 |
| 🔗 双向链接 | 任务和笔记自动双向关联 |
| 📋 笔记模板 | 自定义任务笔记的模板 |
| 🔍 快速导航 | 从任务直接跳转到对应笔记 |
| 📊 笔记概览 | 在侧边栏查看所有任务笔记 |
安装插件
- 打开「设置」→「第三方插件」→ 关闭「安全模式」
- 点击「浏览」→ 搜索「obsidian-tasknotes」→ 安装并启用
基础配置
设置存储位置
Task notes folder: Tasks/Notes
Template: Tasks/Templates/Task Note.md任务笔记模板
创建 Tasks/Templates/Task Note.md:
markdown
---
id: {{task.id}}
created: {{task.created}}
due: {{task.due}}
priority: {{task.priority}}
tags: [任务, {{task.project}}]
---
# {{task.title}}
## 任务描述
{{task.description}}
## 相关信息
**创建时间**: {{task.created}}
**截止日期**: {{task.due}}
**优先级**: {{task.priority}}
## 执行记录
-
## 备注基础操作
为任务创建笔记
| 方法 | 操作 |
|---|---|
| 命令面板 | TaskNotes: Create note for task |
| 快捷键 | 在任务上使用 Ctrl + Shift + N |
| 右键菜单 | 右键任务 → Create task note |
任务语法
markdown
- [ ] 为项目 A 撰写文档 ⏭️ [[Tasks/Notes/project-a-doc]]
- [ ] 完成代码评审 ⏭️ [[Tasks/Notes/code-review]]INFO
使用 ⏭️ 或 ⏩ 表情符号标记有独立笔记的任务。
快速导航
创建笔记后,任务行会自动包含指向笔记的链接:
markdown
- [ ] 撰写项目文档 ⏭️ [[Tasks/Notes/project-doc]]点击链接可直接跳转到对应的任务笔记。
任务笔记结构
典型任务笔记
markdown
---
id: task-20260609-001
created: 2026-06-09
due: 2026-06-15
priority: 高
tags: [任务, 项目A]
---
# 撰写项目文档
## 任务描述
完成项目 A 的技术文档,包括:
- 系统架构图
- API 接口文档
- 部署指南
## 进度追踪
- [ ] 架构设计
- [ ] 编写文档
- [ ] 评审修改
- [ ] 正式发布
## 相关资源
- [[项目 A 主笔记]]
- [[会议记录/架构评审]]
- [外部文档链接](https://example.com)
## 讨论记录
> 2026-06-09: 确定文档结构
> 2026-06-10: 完成初稿
## 附件
-使用场景
复杂任务管理
markdown
# 项目 Alpha - 主任务
## 子任务(各自有独立笔记)
- [ ] 需求分析 ⏭️ [[Tasks/Notes/alpha-requirements]]
- [[Tasks/Notes/alpha-requirements#与客户确认需求|确认进度]]
- [ ] 系统设计 ⏭️ [[Tasks/Notes/alpha-design]]
- [ ] 编码开发 ⏭️ [[Tasks/Notes/alpha-development]]
- [ ] 测试验证 ⏭️ [[Tasks/Notes/alpha-testing]]
- [ ] 部署上线 ⏭️ [[Tasks/Notes/alpha-deployment]]项目管理
markdown
# 📊 项目管理仪表盘
## 进行中的项目
```dataview
TABLE
file.link AS 项目,
file.frontmatter.progress AS 进度,
file.frontmatter.due AS 截止
FROM "Tasks/Projects"
WHERE file.frontmatter.status = "进行中"
SORT file.frontmatter.due ASC里程碑
- [ ] M1: 需求冻结 ⏭️ [[Tasks/Milestones/m1-freeze]]
- [ ] M2: 开发完成 ⏭️ [[Tasks/Milestones/m2-complete]]
- [ ] M3: 测试通过 ⏭️ [[Tasks/Milestones/m3-qa]]
- [ ] M4: 正式上线 ⏭️ [[Tasks/Milestones/m4-launch]]
### 习惯养成
```markdown
# 🎯 习惯养成追踪
## 每日习惯
- [ ] 早起 06:30 ⏭️ [[Tasks/Habits/early-rising]]
- [ ] 晨跑 30 分钟 ⏭️ [[Tasks/Habits/morning-run]]
- [ ] 冥想 10 分钟 ⏭️ [[Tasks/Habits/meditation]]
- [ ] 阅读 30 分钟 ⏭️ [[Tasks/Habits/reading]]
---
# Tasks/Habits/morning-run.md
## 晨跑习惯
### 目标
每周跑步 4 次,每次 30 分钟以上
### 记录
| 日期 | 时长 | 距离 | 感受 |
|------|------|------|------|
| 2026-06-09 | 35min | 5km | 良好 |
| 2026-06-08 | 30min | 4.5km | 一般 |与其他插件配合
配合 Tasks 插件
markdown
- [ ] 重要任务 📅 2026-06-15 ⏭️ [[Tasks/Notes/important-task]]
- 优先级: !!!!
- 标签: #紧急 #重要配合 Dataview
dataview
TABLE
file.link AS 任务,
file.frontmatter.priority AS 优先级,
file.frontmatter.due AS 截止日期,
length(filter(file.tasks, t => t.completed)) AS 子任务进度
FROM "Tasks/Notes"
WHERE file.frontmatter.due <= date(today) + dur(7 days)
SORT file.frontmatter.due ASC配合 Calendar
在日历视图中显示有任务笔记的日期:
dataview
LIST file.link AS 任务
FROM "Tasks/Notes"
WHERE file.frontmatter.due = date(today)配置选项
| 选项 | 说明 | 默认值 |
|---|---|---|
| 任务笔记文件夹 | 存储任务笔记的目录 | Tasks/Notes |
| 笔记模板 | 任务笔记使用的模板 | Tasks/Templates/... |
| 自动创建 | 标记时自动创建笔记 | false |
| 反向链接显示 | 在笔记中显示关联任务 | true |
常见问题
Q: 如何批量创建任务笔记?
使用 QuickAdd 或 Templater 宏批量处理:
javascript
// 批量为已标记的任务创建笔记
const tasks = app.workspace.getActiveFile().tasks;
for (const task of tasks) {
if (task.text.includes('⏭️')) {
await app.commands.executeCommandById('tasknotes:create-note');
}
}Q: 任务笔记和任务本身如何保持同步?
建议将任务笔记作为主要信息来源,任务行作为快速概览,两者定期同步更新。
Q: 如何导出任务笔记数据?
使用 Dataview 查询并导出:
dataview
EXPORT
TABLE file.link, file.frontmatter.due, file.frontmatter.priority
FROM "Tasks/Notes"
WHERE file.frontmatter.due <= date(today)