免费 - iOS与Mac 
免费 - Android TaskNotes 集成指南:使用 YAML 前置元数据的单文件任务
了解 TaskForge 如何支持 Obsidian 的 TaskNotes 格式,让您可以使用 YAML 前置元数据管理单文件任务。非常适合详细的任务文档、丰富的元数据和结构化的笔记工作流程。
什么是 TaskNotes 格式?
TaskNotes 是一种任务管理格式,使用 YAML 前置元数据将每个任务存储在单独的文件中。与散布在笔记中的内联任务不同,TaskNotes 为每个任务提供了专用文件,具有结构化属性和充足的详细文档空间。
单文件任务
每个任务都存放在自己的 markdown 文件中,为您提供无限的笔记、附件和文档空间。
YAML 前置元数据
在结构化的 YAML 前置元数据中存储任务元数据,包括状态、优先级、日期、标签和自定义属性。
灵活识别
通过标签或自定义属性识别 TaskNotes。选择最适合您工作流程的方法。
可配置文件夹
为新的 TaskNotes 设置默认文件夹,并根据您的库结构进行组织。
TaskNotes 文件示例
以下是 Obsidian 库中典型的 TaskNotes 文件的样子:
---
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 配置 TaskNotes
- 1
Enable 任务文件
Open 设置 > 任务类型, toggle '任务文件' on, then tap '任务文件设置' to configure identification, default folder, and field mapping.
- 2
选择识别方法
选择 TaskForge 应如何识别 TaskNotes 文件:通过特定标签(例如 #task)或通过自定义属性(例如 type: task)。
- 3
设置默认文件夹
选择应在何处创建新 TaskNotes 的默认文件夹。这有助于保持库的组织性。
- 4
选择默认格式
决定默认情况下应将新任务创建为 TaskNotes 还是内联任务。您始终可以为每个自定义列表覆盖此设置。
- 5
自定义字段映射(可选)
高级:如果您在库中使用不同的字段名称,请自定义 YAML 属性名称。
TaskNotes 与内联任务的比较
使用 TaskNotes 的情况:
- 您需要详细的任务文档
- 任务需要多个笔记和附件
- 您更喜欢结构化的元数据
- 任务是复杂的项目
- 您想要可搜索的任务存档
使用内联任务的情况:
- 任务是简单的行动项
- 任务属于会议笔记
- 您更喜欢嵌入上下文中的任务
- 快速捕获是优先事项
- 您使用 Obsidian Tasks 插件
好消息: 您不必选择！TaskForge 并排支持两种格式。对大型项目使用 TaskNotes，对快速行动项使用内联任务，，全部集中在一个统一的任务列表中。
有哪些高级 TaskNotes 功能可用?
除了一个任务一个文件管理的基础功能外,TaskNotes 还提供多项高级功能,让您可以根据精确的工作流程定制系统。如果您已经有了既定的 vault 结构或特定的笔记组织惯例,这些选项尤其有用。
自定义字段映射
如果您的 vault 已经使用不同的 YAML 属性名称,您无需更改它们。TaskForge 允许您将默认字段名称重新映射为您自己的名称。例如,如果您使用 'state' 而非 'status',或 'importance' 而非 'priority',您可以配置 TaskForge 直接读写这些字段。这意味着您可以在不重构任何现有文件的情况下采用 TaskNotes。
自定义文件名格式
使用 {title}、{date} 和 {priority} 等变量精确控制新 TaskNotes 文件的命名方式。例如,您可以将格式设置为 '{date}-{title}',使每个任务文件以创建日期开头,方便在 Obsidian 的文件浏览器中按时间顺序排序文件。
正文模板
定义默认的 markdown 正文模板,该模板会插入到每个新的 TaskNotes 文件中。如果您总是希望任务文件中有笔记部分、清单部分和链接部分,只需设置一次模板,每个新任务就会以该结构开始。模板可以省去您反复输入相同模板内容的麻烦。
项目和上下文
TaskNotes 支持使用 +项目名称 和 @上下文 语法的项目和上下文注释。用 +WebsiteRedesign 标记任务以将其绑定到特定项目,或用 @office 指示工作应在何处完成。这些注释与常规标签协同工作,为您提供更丰富的方式来分类和筛选 vault 中的任务。
如何从内联任务迁移到 TaskNotes?
如果您一直在使用内联任务并希望开始利用 TaskNotes,好消息是您不必一次性切换所有内容。TaskForge 同时支持两种格式,因此您可以按自己的节奏逐步迁移。
从复杂任务开始
最适合迁移的是那些已经超出单行的任务。如果您发现自己在向内联任务添加长描述、多个子任务或参考链接,那么该任务天然适合 TaskNotes 格式,在那里它可以获得自己的文件和无限的文档空间。
保持简单任务为内联
并非每个任务都需要自己的文件。'买菜'或'回复Sara的邮件'等快速行动项目作为内联任务完全可行。将 TaskNotes 格式留给那些真正受益于结构化元数据和详细笔记的任务。
同时使用两种格式
TaskForge 在同一个统一任务列表中同时显示内联任务和 TaskNotes。您无需担心混合格式,两种类型都会出现在您的自定义列表、日历视图和小部件中。应用程序在后台处理差异,让您可以专注于工作。
在专用文件夹中组织 TaskNotes
在您的 vault 中为 TaskNotes 文件创建一个专用文件夹,如 'Tasks' 或 'TaskNotes'。这可以保持 vault 整洁,并方便在 Obsidian 的文件浏览器中找到任务文件。在 TaskForge 设置中将此文件夹设为默认位置,这样每个新的 TaskNotes 文件都会自动保存到正确的位置。
分批迁移
与其一次性转换所有内联任务,不如先选择一个项目或生活领域进行迁移。将工作任务移到 TaskNotes 一周,看看感觉如何。一旦熟悉了工作流程,再扩展到其他领域。这种渐进式方法让您可以在完全投入之前优化字段映射和模板。
准备尝试 TaskNotes?
下载 TaskForge 并开始在 Obsidian 中使用 TaskNotes 格式进行详细的任务管理工作流程。 了解所有TaskNotes功能请访问 功能页面 并查看 最新TaskNotes增强功能 获取最新更新。
软件工程师，拥有 10+ 年使用 Swift、Kotlin 和 Flutter 开发移动端与桌面应用的经验。独立开发者，现居 Toronto, Canada。TaskForge 的作者。 了解更多