TaskNotes 集成指南:使用 YAML 前置元数据的单文件任务
了解 TaskForge 如何支持 Obsidian 的 TaskNotes 格式，让您可以使用 YAML 前置元数据管理单文件任务。非常适合详细的任务文档、丰富的元数据和结构化的笔记工作流程。
前置元数据记录任务的状态、优先级和截止日期。正文完全由你掌控，写笔记、放链接，或者放任何这项工作需要的东西。
免费 - iOS与Mac 
免费 - Android 什么是 TaskNotes 格式？
TaskNotes 是一种任务管理格式，使用 YAML 前置元数据将每个任务存储在单独的文件中。与散布在笔记中的内联任务不同，TaskNotes 为每个任务提供了专用文件，具有结构化属性和充足的详细文档空间。
单文件任务
每个任务都存放在自己的 markdown 文件中，为您提供无限的笔记、附件和文档空间。
YAML 前置元数据
在结构化的 YAML 前置元数据中存储任务元数据，包括状态、优先级、日期、标签和自定义属性。
灵活识别
通过标签或自定义属性识别任务文件。选择最适合您工作流程的方法。
可配置文件夹
为新的任务文件设置默认文件夹，并根据您的库结构进行组织。
任务文件示例
以下是 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
Enable 任务文件
Open 设置 > 任务类型， toggle '任务文件' on, then tap '任务文件设置' to configure identification, default folder, and field mapping.
- 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 格式，在那里它可以获得自己的文件和无限的文档空间。
保持简单任务为内联
并非每个任务都需要自己的文件。'买菜'或'回复Sara的邮件'等快速行动项目作为内联任务完全可行。将 TaskNotes 格式留给那些真正受益于结构化元数据和详细笔记的任务。
同时使用两种格式
TaskForge 在同一个统一列表视图中同时显示内联任务和任务文件。您无需担心混合格式，两种类型都会出现在您的自定义列表、日历视图和小组件中。应用程序在后台处理差异，让您可以专注于工作。
在专用文件夹中组织任务文件
在您的仓库中为任务文件创建一个专用文件夹，如 'Tasks' 或 '任务文件'。这可以保持仓库整洁，并方便在 Obsidian 的文件浏览器中找到任务文件。在 TaskForge 设置中将此文件夹设为默认位置，这样每个新的任务文件都会自动保存到正确的位置。
分批迁移
与其一次性转换所有内联任务，不如先选择一个项目或生活领域进行迁移。将工作任务移到任务文件一周，看看感觉如何。一旦熟悉了工作流程，再扩展到其他领域。这种渐进式方法让您可以在完全投入之前优化字段映射和模板。
准备尝试 TaskNotes?
下载 TaskForge 并开始在 Obsidian 中使用 TaskNotes 格式进行详细的任务管理工作流程。 了解所有TaskNotes功能请访问 功能页面 并查看 最新TaskNotes增强功能 获取最新更新。
