A stateless, zero-database task management plugin for Obsidian. Simple Tasks scans your vault in real-time using Obsidian's metadata cache to aggregate tasks based on simple markdown syntax.
- High Performance: Uses
metadataCachefor fast scanning. - Live Updates: Automatically refreshes views when you modify your notes.
- Smart Autocomplete: Type
[]anywhere in a line to pick a category and auto-format/convert the line into a task. - Collapsible Filters: Keep your workspace clean by collapsing the filter settings while keeping the task list visible.
- Dual View Modes: Show a task list and a progress summary (Stats) simultaneously.
Simple Tasks recognizes standard markdown tasks. You can enrich them with categories, dates, and tags.
- Standard Task:
- [ ] Buy milk - With Category:
- [ ] ==Personal== Buy milk- Categories are defined using highlight syntax
==.
- Categories are defined using highlight syntax
- With Due Date:
- [ ] Buy milk 2025-03-01(Format:YYYY-MM-DD)
In any note, type [] (or [ ], [x]) anywhere in a line.
- A category menu appears immediately.
- Selecting a category inserts it at your cursor.
- If the line isn't a task, it is automatically converted (prepending
- [ ]). - To add more categories, simply type
[]again.
Create a code block starting with simpletasks. Use the Save 💾 button in the header to persist your interactive filters back to the code block.
| Option | Values | Description |
|---|---|---|
title: |
text |
The title displayed in the header. |
view: |
list, stats, list stats |
Choose to show the list, the stats summary, or both. |
status: |
undone, done, all |
Filter by completion status. |
sort: |
date, file |
Sort order (Default: date). |
tags: |
#tag1, #tag2 |
Show ONLY tasks containing these tags (OR logic). |
folders: |
Folder1, Folder2 |
Show ONLY tasks from these folders (OR logic). |
expanded: |
true, false |
Whether the filter header is expanded by default. |
- Collapse Button (+ / −): Located in the title line, toggles filter visibility.
- View Checkboxes: Toggle "List" and "Stats" views in real-time.
- Save Filters (💾): Overwrites the code block with your current interactive configuration.
- Category Chips: Click chips to toggle multi-category filtering. "All" resets filters.
- Rescan (⟳): Force a manual vault scan.