跳转到主要内容
TaskForge 3.0:AI 能读任务了
集成

TaskNotes 集成指南:使用 YAML frontmatter 的单文件任务

了解 TaskForge 如何支持 Obsidian 的 TaskNotes 格式,让你可以使用 YAML frontmatter 管理单文件任务。非常适合详细的任务文档、丰富的元数据和结构化的笔记工作流程。

Review PR.md ● 已保存
---
status: in-progress
priority: high
due: 2025-10-15
---
# 审查 PR
- [ ] 代码质量与模式

frontmatter 记录任务的状态、优先级和截止日期。正文完全由你掌控,写笔记、放链接,或者放任何这项工作需要的东西。

查看所有功能

什么是 TaskNotes 格式?

TaskNotes 是一种任务管理格式:每个任务单独存成一个文件,元数据写在 YAML frontmatter 中。和散落在各处笔记里的内联任务不同,TaskNotes 给每个任务一个专属文件,既有结构化属性,也有足够的空间写详细文档。

单文件任务

每个任务都有自己的 Markdown 文件,笔记、附件和文档想写多少写多少。

YAML frontmatter

在结构化的 YAML frontmatter 中存储任务元数据,包括状态、优先级、日期、标签和自定义属性。

灵活识别

通过标签或自定义属性识别任务文件。选择最适合你工作流程的方法。

可配置文件夹

为新的任务文件设置默认文件夹,并根据你的仓库结构进行组织。

任务文件示例

一个典型的任务文件在 Obsidian 仓库里是这样的:

---
status: in-progress
priority: high
due: 2025-10-15
tags:
  - work
  - project-alpha
created: 2025-10-01
---

# Review PR #123

Review the new authentication system PR and provide feedback on:

- [ ] Code quality and patterns
- [ ] Test coverage
- [ ] Documentation completeness
- [ ] Security considerations

## Notes

- Need to verify the new token refresh logic
- Check that rate limiting is properly implemented
- Test with various user permission levels

## Links

- [[Authentication Design Doc]]
- [[Security Guidelines]]

支持的属性

状态

任务完成状态:待办、进行中、暂停、计划或完成

status: in-progress

优先级

任务重要性:最高、高、中、低或最低

priority: high

日期

截止日期、计划日期、开始日期和完成日期

due: 2025-10-15 scheduled: 2025-10-10 start: 2025-10-01

标签

用列表格式写多个标签来整理任务

tags:
  - work
  - urgent
  - project-alpha

重复

设置间隔灵活的重复任务

recurrence: every week

配置任务文件

  1. 1

    启用任务文件

    打开“设置 → 任务类型”,开启“任务文件”,然后点击“任务文件设置”,配置识别方式、默认文件夹和字段映射。

  2. 2

    选择识别方法

    选择 TaskForge 应如何识别任务文件:通过特定标签(例如 #task)或通过自定义属性(例如 type: task)。

  3. 3

    设置默认文件夹

    选择新任务文件默认存放的文件夹,让仓库保持井井有条。

  4. 4

    选择默认格式

    决定新任务默认创建为任务文件还是内联任务。每个自定义空间也可以单独设置。

  5. 5

    自定义字段映射(可选)

    高级:如果你在仓库中使用不同的字段名称,请自定义 YAML 属性名称。

任务文件与内联任务的比较

以下情况适合用任务文件:

  • 你需要详细的任务文档
  • 任务需要多个笔记和附件
  • 你更喜欢结构化的元数据
  • 任务是复杂的项目
  • 你希望任务归档后仍能搜索

以下情况适合用内联任务:

  • 任务是简单的行动项
  • 任务本来就写在会议记录里
  • 你希望任务就嵌在相关的笔记内容里
  • 注重快速记录
  • 你使用 Obsidian Tasks 插件

好消息: 不必二选一!TaskForge 同时支持两种格式:大型项目用任务文件,零散待办用内联任务,全部汇集在同一个列表视图中。

有哪些高级 TaskNotes 功能可用?

除了“一个任务一个文件”的基础管理,TaskNotes 还提供多项高级功能,让你按自己的工作流精细定制。如果你已经有固定的仓库结构或笔记整理习惯,这些选项尤其有用。

自定义字段映射

如果你的仓库已经在用别的 YAML 属性名,不需要改。TaskForge 可以把默认字段名重新映射成你的名称。比如你用“state”代替“status”,或用“importance”代替“priority”,可以让 TaskForge 直接读写这些字段。也就是说,不必改动任何现有文件,就能用上 TaskNotes。

自定义文件名格式

用 {title}、{date} 和 {priority} 等变量,精确控制新任务文件的命名方式。例如,把格式设为“{date}-{title}”,每个任务文件都会以创建日期开头,方便在 Obsidian 的文件浏览器中按时间排序。习惯按日期命名的人会觉得尤其方便。

正文模板

定义一个默认的 Markdown 正文模板,每个新任务文件都会自动插入。如果你希望任务文件里总有“笔记”“清单”和“链接”几个部分,只需设置一次正文模板,之后每个新任务都从这个结构开始。模板能省去反复输入相同样板内容的麻烦。

项目和上下文

TaskNotes 支持用 +项目名称 和 @上下文 语法标注项目和上下文。用 +WebsiteRedesign 把任务关联到某个项目,或用 @office 标明工作在哪里完成。这些标注和普通标签一起使用,让你能更细致地分类和筛选仓库中的任务。

如何从内联任务迁移到任务文件?

如果你一直在用内联任务,想开始用任务文件,好消息是不必一次全部切换。TaskForge 同时支持两种格式,你可以按自己的节奏逐步迁移。

1

从复杂任务开始

最适合迁移的,是一行已经装不下的任务。如果你发现自己在给某个内联任务加长描述、多个子任务或参考链接,它就很适合改用 TaskNotes 格式:拥有自己的文件,文档想写多少写多少。

2

简单任务继续用内联

并不是每个任务都需要单独一个文件。“买菜”或“回复 Sarah 的邮件”这类小事,用内联任务就够了。把 TaskNotes 格式留给真正需要结构化元数据和详细笔记的任务。

3

同时使用两种格式

TaskForge 会在同一个列表视图中同时显示内联任务和任务文件。不用担心格式混用:两种任务都会出现在自定义空间、日历视图和小组件中。差异由应用在后台处理,你只管专心工作。

4

把任务文件放进专用文件夹

在仓库中为任务文件建一个专用文件夹,比如“Tasks”或“任务文件”。这样仓库更整洁,并方便在 Obsidian 的文件浏览器中找到任务文件。在 TaskForge 设置中将此文件夹设为默认位置,这样每个新的任务文件都会自动保存到正确的位置。

5

分批迁移

与其一次转换全部内联任务,不如先挑一个项目或一个生活领域来迁移。比如先把工作任务改成任务文件,用一周看看感觉。熟悉之后,再扩展到其他领域。这样循序渐进,你可以在全面切换之前把字段映射和模板调好。

想试试 TaskNotes?

下载 TaskForge,在 Obsidian 中用 TaskNotes 格式管理需要细致记录的任务。 在我们的 功能页面 了解 TaskNotes 的全部功能,并查看 TaskNotes 最新增强 ,掌握最近的更新。

Azhar Dewji
Azhar Dewji · 2025年11月3日 · 更新于 2026年7月18日

软件工程师,有 10 余年使用 Swift、Kotlin 和 Flutter 开发移动端与桌面应用的经验。独立开发者,现居加拿大多伦多。TaskForge 的开发者。 了解更多