%% ----- Badges ----- %%
![GitHub all releases](https://img.shields.io/github/downloads/obsidian-tasks-group/obsidian-tasks/total?color=573E7A&logo=github&style=for-the-badge)
![GitHub manifest version](https://img.shields.io/github/manifest-json/v/obsidian-tasks-group/obsidian-tasks?color=573E7A&logo=github&style=for-the-badge)
![GitHub issues by-label](https://img.shields.io/github/issues/obsidian-tasks-group/obsidian-tasks/help%20wanted?color=573E7A&logo=github&style=for-the-badge)
![GitHub Repo stars](https://img.shields.io/github/stars/obsidian-tasks-group/obsidian-tasks?color=573E7A&logo=github&style=for-the-badge)
%% ----- Badges ----- %%
%% ----- Do not edit this section ----- %%
# Tasks
Plugin ID: `obsidian-tasks-plugin`
Links: [GitHub repository](https://github.com/obsidian-tasks-group/obsidian-tasks) or [<button id=HH>Open in Obsidian</button>](obsidian://show-plugin?id=obsidian-tasks-plugin)
Developed by: [[obsidian-tasks-group]] - [[claremacrae]] (and formerly [[schemar]])
Mobile compatible: [[Mobile-compatible plugins|Yes]]
Task management for Obsidian
%% ----- Do not edit anything above this line ----- %%
%% The repository or author does not have any sponsoring links. %%
For complete information, see the **[official documentation](https://obsidian-tasks-group.github.io/obsidian-tasks/)**.
---
## Summary
Track checklist items/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.
Tasks tracks your checklist items from your vault. The simplest way to create a new task is to create a new checklist item. The markdown syntax for checklist items is a list item that starts with spaced brackets: `- [ ] take out the trash`. Now Tasks tracks that you need to take out the trash!
A more convenient way to create a task is by using the `Tasks: Create or edit` command from the command palette. You can also bind a hotkey to the command. The command will parse what's on the current line in your editor and pre-populate a modal. In the modal, you can change the task's description, its due date, and a recurrence rule to have a repeating task.
---
## Screenshots
*All screenshots assume the global filter `#task` which is not set by default (see also "Getting Started").*
![ACME Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks/raw/gh-pages/docs/images/acme.png)
The `ACME` note has some tasks.
![Important Project Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks/raw/gh-pages/docs/images/important_project.png)
The `Important Project` note also has some tasks.
![Tasks Queries](https://github.com/obsidian-tasks-group/obsidian-tasks/raw/gh-pages/docs/images/tasks_queries.png)
The `Tasks` note gathers all tasks from the vault and displays them using queries.
![Create or Edit Modal](https://github.com/obsidian-tasks-group/obsidian-tasks/raw/gh-pages/docs/images/modal.png)
The `Tasks: Create or edit` command helps you when editing a task.
%% Hub footer: Please don't edit anything below this line %%
# This note in GitHub
<span class="git-footer">[Edit In GitHub](https://github.dev/obsidian-community/obsidian-hub/blob/main/02%20-%20Community%20Expansions/02.05%20All%20Community%20Expansions/Plugins/obsidian-tasks-plugin.md "git-hub-edit-note") | [Copy this note](https://raw.githubusercontent.com/obsidian-community/obsidian-hub/main/02%20-%20Community%20Expansions/02.05%20All%20Community%20Expansions/Plugins/obsidian-tasks-plugin.md "git-hub-copy-note") | [Download this vault](https://github.com/obsidian-community/obsidian-hub/archive/refs/heads/main.zip "git-hub-download-vault") </span>