Skip to content

TaskNotes 插件使用指南

TaskNotes 是 Obsidian 中用于为任务创建独立笔记页面的插件,实现任务与笔记的双向关联,让任务管理更加结构化和深度化。

插件特点

特性说明
📝 任务笔记为每个任务创建独立的笔记页面
🔗 双向链接任务和笔记自动双向关联
📋 笔记模板自定义任务笔记的模板
🔍 快速导航从任务直接跳转到对应笔记
📊 笔记概览在侧边栏查看所有任务笔记

安装插件

  1. 打开「设置」→「第三方插件」→ 关闭「安全模式」
  2. 点击「浏览」→ 搜索「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)