obsidian-tasks-group/obsidian-tasks

Obsidian Tasks is a plugin for Obsidian, a note-taking app where you store all your writing in plain Markdown files on your own computer. The plugin adds task-management capabilities on top of that file-based system so you can collect and act on to-do items scattered across many notes in one place. You write tasks directly in any note using Markdown's checkbox syntax: a hyphen, a pair of brackets, and the task description. You can attach extra information to each task: a due date using a calendar emoji, a scheduled date for when you plan to start work, and a recurrence pattern for tasks that repeat on a weekly or monthly basis. When you complete a recurring task, the plugin generates the next occurrence automatically. The main feature is the query block. You drop a specially marked code block into any note, fill it with filtering rules written in plain English, and the plugin renders a live list of all matching tasks from across your entire vault. You can filter by due date, completion status, file name, or custom tags, then group and sort the results however you want. Checking off a task inside a query updates the original source file, so your data stays in your own Markdown files and never moves to a separate database. Installation goes through Obsidian's community plugins browser: search for Tasks, enable it in settings, and optionally assign a keyboard shortcut for toggling tasks done. The full user guide lives at publish.obsidian.md/tasks. The plugin is completely free and has been maintained by Clare Macrae since May 2022. It accepts optional sponsor donations but charges nothing for use.