全局过滤标签 #task 默认未设置,需在设置中自行配置;建议用 Tasks: Toggle Done 热键替换默认的切换复选框热键;查询结果过多(数百上千条)会明显拖慢 Obsidian 编辑性能,可用 limit 限制
obsidian-tasks
obsidian-tasks-groupMIT活跃维护在 Obsidian 笔记里直接管理待办任务,支持截止日期、重复任务和查询过滤,不用离开知识库就能跟踪进度。
Task management for the Obsidian knowledge base.
在 Obsidian 社区插件浏览器中搜索 Tasks 并启用README 未说明,作为 Obsidian 社区插件在 Obsidian 内运行
Obsidian 任务管理插件,跨整个库追踪、查询并勾选任务
在 Obsidian 笔记里直接管理待办任务,支持截止日期、重复任务和查询过滤,不用离开知识库就能跟踪进度。
核心能力
- 用 tasks 查询块跨全库筛选任务
- 支持截止日期、计划日期与重复任务
- 可在任意视图或查询中切换任务完成状态并回写源文件
- 提供 Tasks: Create or edit 命令辅助编辑任务
- 支持按文件名分组、按日期或描述排序
容易踩的坑
- 8.6.08.6.0: Require at least Obsidian 1.13.1; add setting for which field to Postpone最新正式版2026-10-16 · 2026-10-16 21:40 UTC
What's Changed
🌟 Most Notable
Please run the Reload app without saving command or quit and restart Obsidian after updating the plugin. Thank you.
- Update minimum supported Obsidian version to 1.13.1.
- Add setting to control which field the Postpone button edits.
- Development
- Added Obsidian Checks workflow.
Screenshots
Available options
🌟 Features
- feat: add setting to configure postpone button date field by @lingow in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4083
- feat!!: Remove support for Obsidian 1.13.0 and earlier by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4084
- feat: Delete unused "features" settings value (if value was not edited) by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4088
- feat: Delete last unused settings "generalSettings" & "headingOpened" by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4089
- feat!!: Finish removing support for Obsidian 1.13.1 and earlier by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4095
🛠️ Behind the scenes
Other changes:
- chore: Invoke strict obsidian-workflow checks on commits and PRs by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4091
- refactor: Minor improvements to the new postpone settings by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4093
- test: Sample files & tests to see underlying cause of #4081 by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4082
New Contributors
- @lingow made their first contribution in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4083
Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):
🙏 Support Tasks development
- 8.5.08.5.0: Settings completely redesigned for Obsidian 1.13 and above; Quick Search uses Fuzzy search2026-10-10 · 2026-10-10 11:32 UTC
查看更新说明
What's Changed
🌟 Most Notable
Please run the Reload app without saving command or quit and restart Obsidian after updating the plugin. Thank you.
- Add Settings complete redesign, and now searchable, in Obsidian 1.13.0 and above.
- Add Filter box to Presets settings in Obsidian 1.13.0 and above.
- Quick Search now uses Fuzzy search by default, for more matches and better sorting.
- It has an Options button to enable the original substring search, if preferred.
- Documentation
- Development
- Switched to the Vitest Test Framework.
🌟 Features
- feat: Update SettingsTab to use Obsidian 1.13's
getSettingDefinitionsby @liamcain in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3955 - feat: add configurable fuzzy matching to Quick Search by @vw2x in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4022
- feat: Add Filter box to Presets settings page, for Obsidian 1.13.0 and above by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4070
- feat: Add icon to Tasks plugin settings, for Obsidian 1.11.0 and later by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4075
💪 Fixes
- fix: - Add a description to the new Statuses settings section by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4046
🌍 Translations
- i18n: Add missing translation strings by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4069
📖 Documentation
- docs: Write up how to read the user guide offline by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4027
- docs: Update settings screenshots (and refine wording) by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4071
- contrib: Update snippets and examples in markdown by @github-actions[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4043
- contrib: Update snippets and examples in markdown by @github-actions[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4059
- contrib: Update contributing guide for migration to vitest by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4064
🛠️ Dependencies
- build(deps): bump fast-uri from 3.1.4 to 3.1.8 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4028
- build(deps): bump @hono/node-server from 1.19.14 to 1.19.17 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3990
- build(deps): bump postcss-selector-parser from 7.1.1 to 7.1.6 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4024
- build(deps): bump hono from 4.12.31 to 4.13.12 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4033
- build(deps): bump undici from 6.27.0 to 6.29.0 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4053
- build(deps-dev): bump moment from 2.29.4 to 2.31.0 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4052
- build(deps): migrate from svelte 3 to svelte 5 by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4066
🛠️ Behind the scenes
Improvements made to new features prior to their release:
Other changes:
- chore: upgrade to prettier compatible with svelte v5 by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4044
- refactor: Fix more ESLint warnings by @claremacrae in https://github.c
- 8.4.08.4.0: Quick search, Column view (drag-and-drop tasks to change dates and priorities), group counts, Spanish and French translations2026-08-25 · 2026-08-25 21:36 UTC
查看更新说明
What's Changed
🌟 Most Notable
Please run the Reload app without saving command or quit and restart Obsidian after updating the plugin. Thank you.
- Add Quick search command, to find an incomplete task recognised by Tasks anywhere in your vault.
- Add columns view, supporting drag-and-drop edit for a growing number of properties.
- Add show group count instruction. For now, this only shows numbers of tasks in the lowest-level groups.
- Add CSS example for colouring actionable tasks by their priority.
- The default preset
hide_query_elementsnow hides the task count. (Pre-existing Tasks settings are not updated, though.) - Translations of Settings, Editing a Status and Check your Statuses:
- Add Spanish translation.
- Add French translation.
- Documentation:
- Add How to support an existing request to the help on user support.
- Add Support sections to many documentation pages, to help find and up-vote related bugs and feature requests before reporting new ones. Example: Statuses
Main changes
Here are the most notable user-visible changes.
🌟 Features
- feat: Optionally display the number of tasks on lowest-level groups by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3954
- feat: Allow drag-and-drop between columns for some fields by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3964
- feat: Nicer styling of tasks in columns as "cards" by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3968
- feat: Make 'done' & 'not done' explain the status types they find by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3991
- feat: add 'Quick search' command by @vwww-droid in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3994
- feat: Honour the 'Remove global filter' setting in "Quick Search" results display by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4008
- feat: Teach Quick Search command to honour user's Global Query filters by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4010
- feat: Add useful, stable sort order for Quick Search results by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/4015
💪 Fixes
- fix: add 'hide task count' to hide_query_elements preset (#3899) by @Munawarx in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3958
- fix: preserve hard-break spaces when toggling tasks by @obiwankenobi699 in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3970
- fix: avoid extra space when toggling tasks with tag-only descriptions by @obiwankenobi699 in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3976
- fix: Make user CSS for task background colours work in column views by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3979
- fix: tasks without global filter now toggle using Obsidian logic, ignoring custom statuses by @obiwankenobi699 in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3977
- fix: 'view columns' would crash if any col
- 8.3.08.3.0: Stop blocking Obsidian UI during startup; 'hide nested backlinks' instruction; safer regex searches2026-07-23 · 2026-07-23 13:12 UTC
查看更新说明
What's Changed
🌟 Most Notable
Please run the Reload app without saving command or quit and restart Obsidian after updating the plugin. Thank you.
Main changes
Here are the most notable user-visible changes.
🌟 Features
New 'hide/show nested backlink' option by @staniond in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3933
-
When using
show tree, this can make the search results much more readable, if you don't need to jump the exact lines of nested tasks. -
docs: Hide and Show Nested Backlink
Caption: Visual comparison of default display of results with
show treeinstruction (left hand side), and with addedhide nested backlinkadded (right hand side)
💪 Fixes
- fix: Address Edit task modal scrolling issues on mobile by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3918
- fix: Allow users to interact with Obsidian whilst Tasks is loading by @vincentschen in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3929
- fix: stop regex searches freezing Obsidian by catastrophic backtracking by @saberzero1 and @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3946
📖 Documentation
- docs: Show how to find nested tags using task.file.property('tags') by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3915
- docs: Update Reminders plugin interop notes for current behavior by @uphy in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3930
- docs: Update snippets and examples in markdown by @github-actions[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3943
🛠️ Dependencies
- chore(deps): bump immutable from 4.3.8 to 4.3.9 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3947
- chore(deps): bump fast-uri from 3.1.2 to 3.1.4 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3948
- chore(deps): bump linkify-it from 5.0.0 to 5.0.2 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3949
- chore(deps): bump hono from 4.12.23 to 4.12.31 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3950
- chore(deps-dev): bump @evilmartians/lefthook from 1.7.2 to 2.1.10 [REVERTED] by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3886
- chore(deps-dev): bump esbuild from 0.27.4 to 0.28.1 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3900
- chore(deps): bump @babel/core from 7.15.8 to 7.29.7 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3905
- chore(deps): bump actions/checkout from 6 to 7 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3906
- chore(deps): bump undici from 6.24.1 to 6.27.0 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3910
- chore(deps): bump actions/setup-node from 6 to 7 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3934
- chore(deps): bump ws from 8.18.3 to 8.21.1 by @dependabot[bot] in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3951
- chore(deps-dev): downgrade @evilmartians/lefthook from 2.1.10 back down to 1.7.2 (#3952) by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3953
🛠️ Behind the scenes
Improvements made to new features prior to their release:
- feat: add initial implementation of columns view by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3935
Other changes:
- chore: Update eslint-plugin-obsidianmd to 0.4.0 by @claremacrae in
-
- 8.2.28.2.2: Editing task statuses no longer jumps to the top of the Tasks settings tab2026-06-22 · 2026-06-22 08:13 UTC
查看更新说明
Please run the Reload app without saving command or quit and restart Obsidian after updating the plugin. Thank you.
- fix: Stop status setting edits jumping to top by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/3909
Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):
🙏 Support Tasks development
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
Track tasks across your entire vault. Query them and mark them as done wherever you want. Supports due dates, recurring tasks (repetition), done dates, sub-set of checklist items, and filtering.
You can toggle the task status in any view or query and it will update the source file.
For changes in each release, please check the releases page: https://github.com/obsidian-tasks-group/obsidian-tasks/releases
Screenshots
- All screenshots assume the global filter
#taskwhich is not set by default (see also installation). - The theme is default Obsidian theme.
The ACME note has some tasks.
The Important Project note also has some tasks.
The Tasks note gathers all tasks from the vault and displays them using queries.
The Tasks: Create or edit command helps you when editing a task.
Installation
Follow the steps below to install Tasks.
- Search for "Tasks" in Obsidian's community plugins browser
- Enable the plugin in your Obsidian settings (find "Tasks" under "Community plugins").
- Check the settings. It makes sense to set the global filter early on (if you want one).
- Replace the "Toggle checkbox status" hotkey with "Tasks: Toggle Done".
- I recommend you remove the original toggle hotkey and set the "Tasks" toggle to
Ctrl + Enter(orCmd + Enteron a mac).
- I recommend you remove the original toggle hotkey and set the "Tasks" toggle to
Getting Started
Write some tasks
Create a few tasks in a Markdown note in your vault. For example:
- [ ] Something non-important, with no date
- [ ] Remember to do that important thing - with a due date 📅 2022-12-17
- [ ] Send Kate a birthday card - with a scheduled date 🔁 every January on the 4th ⏳ 2023-01-04
Find out more in Getting Started, and its sub-sections.
Create your first Tasks search
And then write a Tasks search block somewhere in your Obsidian vault, to find the tasks that are interesting.
Here is an example that shows a few different features. View it in Reading or Live Preview modes to see the results.
```tasks
## Only tasks that are not done, that is, which begin like this (but without the quotes):
## '- [ ] ' or
## '* [ ] ' or
## '1. [ ] '
## Indented tasks are supported, but only single-line tasks.
not done
## Tasks due today or earlier:
due before tomorrow
## Restrict to at most 100 tasks.
## If you ask Tasks to display many hundreds or thousands of tasks,
## Obsidian's editing performance really slows down.
limit 100
## Group and sort the output:
group by filename
sort by due reverse
sort by description
## Optionally, ask Tasks to explain how it interpreted this query:
explain
```
Find out more in Queries, and its sub-sections.
Documentation
For user documentation, please check https://publish.obsidian.md/tasks/.
Development
Clone the repository, run yarn to install the dependencies, and run yarn dev to compile the plugin and watch file changes.
Then see the Contributing Guide.
Donations
The plugin is completely free to use, and very willingly developed and supported by Clare Macrae since May 2022.
If you have particularly been helped by the Tasks plugin and wish to support it, please see the following link.
Donations will go towards my computing costs and licenses for development tools that I use for productivity.
Thank you 🙏.