TaskNotes 集成指南:使用 YAML frontmatter 的单文件任务
了解 TaskForge 如何支持 Obsidian 的 TaskNotes 格式,让你可以使用 YAML frontmatter 管理单文件任务。非常适合详细的任务文档、丰富的元数据和结构化的笔记工作流程。
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
启用任务文件
打开“设置 → 任务类型”,开启“任务文件”,然后点击“任务文件设置”,配置识别方式、默认文件夹和字段映射。
- 2
选择识别方法
选择 TaskForge 应如何识别任务文件:通过特定标签(例如 #task)或通过自定义属性(例如 type: task)。
- 3
设置默认文件夹
选择新任务文件默认存放的文件夹,让仓库保持井井有条。
- 4
选择默认格式
决定新任务默认创建为任务文件还是内联任务。每个自定义空间也可以单独设置。
- 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 同时支持两种格式,你可以按自己的节奏逐步迁移。
从复杂任务开始
最适合迁移的,是一行已经装不下的任务。如果你发现自己在给某个内联任务加长描述、多个子任务或参考链接,它就很适合改用 TaskNotes 格式:拥有自己的文件,文档想写多少写多少。
简单任务继续用内联
并不是每个任务都需要单独一个文件。“买菜”或“回复 Sarah 的邮件”这类小事,用内联任务就够了。把 TaskNotes 格式留给真正需要结构化元数据和详细笔记的任务。
同时使用两种格式
TaskForge 会在同一个列表视图中同时显示内联任务和任务文件。不用担心格式混用:两种任务都会出现在自定义空间、日历视图和小组件中。差异由应用在后台处理,你只管专心工作。
把任务文件放进专用文件夹
在仓库中为任务文件建一个专用文件夹,比如“Tasks”或“任务文件”。这样仓库更整洁,并方便在 Obsidian 的文件浏览器中找到任务文件。在 TaskForge 设置中将此文件夹设为默认位置,这样每个新的任务文件都会自动保存到正确的位置。
分批迁移
与其一次转换全部内联任务,不如先挑一个项目或一个生活领域来迁移。比如先把工作任务改成任务文件,用一周看看感觉。熟悉之后,再扩展到其他领域。这样循序渐进,你可以在全面切换之前把字段映射和模板调好。
想试试 TaskNotes?
下载 TaskForge,在 Obsidian 中用 TaskNotes 格式管理需要细致记录的任务。 在我们的 功能页面 了解 TaskNotes 的全部功能,并查看 TaskNotes 最新增强 ,掌握最近的更新。
相关文章
- 主屏幕上的 TaskNotes 在小组件里查看任务,随手勾掉。有日期的任务到期时,提醒会让你及时想起它。两者用的都是你仓库里的 TaskNotes。 阅读更多
- 2.0 版本 TaskNotes 功能增强 了解 TaskNotes 的最新改进,包括编辑、格式和整理功能的增强。 阅读更多
- 掌握 Obsidian 中的重复任务 了解如何用灵活的重复规则设置和管理重复任务,完成后自动生成下一次。 阅读更多
- Obsidian Tasks 插件完整指南 掌握 Obsidian Tasks 插件语法:在仓库中使用日期、优先级、重复任务和筛选。 阅读更多
- Obsidian 任务格式对比:表情符号、Dataview、文件 表情符号、Dataview 字段、Task Genius,还是一个任务一篇笔记?各种 Obsidian 任务格式的优势、哪些插件能读取,以及开始前该怎么选。 阅读更多