Obsidian Plugin
The Obsidian plugin turns wikilinks to task files into interactive widgets. Link to a task from anywhere in your vault and see its status, project, dates, and other metadata inline. Check off tasks without opening the file.
Features
Section titled “Features”- Interactive task widgets — Wikilinks to tasks render with checkboxes, status indicators, project/area, and due dates
- Status colours — Coloured borders show task state at a glance (blue for inbox, yellow for in-progress, red for blocked)
- Check off tasks — Click the checkbox to mark tasks done without leaving your note
- Convert checklist items — Right-click any checklist item to turn it into a Taskdn task file
- Inline title replacement — Display the task’s title frontmatter instead of the kebab-case filename, with a status-coloured border
Installation
Section titled “Installation”The plugin needs Obsidian 1.13 or later, with Use [[Wikilinks]] turned on in Settings → Files and links.
From Community Plugins
Section titled “From Community Plugins”Taskdn is in Obsidian’s community plugin directory. If you have Obsidian installed, this button opens Taskdn’s page in Obsidian’s plugin browser. Click Install, then Enable.
Add to ObsidianOr find it from inside Obsidian:
-
Go to Settings → Community plugins and turn on community plugins if you haven’t already
-
Click Browse and search for “Taskdn”
-
Click Install, then Enable
Updates appear in Settings → Community plugins alongside your other plugins’ updates.
Manual Install
Section titled “Manual Install”-
Download
main.js,manifest.jsonandstyles.cssfrom the latest release -
Copy them into
YOUR_VAULT/.obsidian/plugins/taskdn/, creating thetaskdnfolder if it doesn’t existThe
.obsidianfolder is hidden by default. PressCmd+Shift+.in the macOS Finder orCtrl+Hin most Linux file managers to show it. -
Restart Obsidian
-
Go to Settings → Community plugins, find “Taskdn”, and enable it
Configuration
Section titled “Configuration”Open Settings → Taskdn to configure the plugin. Changes apply straight away, and the settings show up in Obsidian’s settings search.
| Setting | Description |
|---|---|
| Tasks directory | Folder containing your task files (default: tasks) |
| Default status for new tasks | Status given to tasks converted from checklist items: inbox, ready or icebox (default: inbox) |
| Show desktop app button | Adds a button to task widgets that opens the task in the desktop app (default: off) |
| Ignored files | Task files that never render as widgets, one pattern per line, with * as a wildcard. A pattern containing / matches a path relative to the tasks directory (archive/*). One without matches a file name in any folder (*-template) |
| Use task title as inline title | Show the title frontmatter instead of the filename in the inline title. Only appears when Obsidian’s Show inline title is on |
| Sync filename with task title | Also rename the file when you edit the inline title. Only appears when Use task title as inline title is on |
Link to task files using standard wikilink syntax:
- [[call-dentist]]- [[review-quarterly-report]]- Check out [[website-redesign]] when you have timeWorks in both Live Preview and Reading mode. Tasks in bullet lists behave like native Obsidian checklists—completed tasks get strikethrough styling.
Inline Title
Section titled “Inline Title”By default, Obsidian displays the filename as the inline title at the top of documents. For task files, this means you see buy-groceries instead of “Buy groceries”. The plugin can replace this with the human-readable title from frontmatter.
- Enable Settings → Appearance → Show inline title (Obsidian’s native setting)
- Enable Settings → Taskdn → Use task title as inline title
Status Border
Section titled “Status Border”When enabled, a coloured left border appears indicating the task’s status:
| Status | Border Colour |
|---|---|
| inbox | Blue |
| icebox | Cyan |
| ready | Grey |
| in-progress | Yellow |
| blocked | Red |
| dropped | Pink |
| done | Green |
Editing the Title
Section titled “Editing the Title”Click the inline title to edit. When you finish (press Enter or click away), the plugin:
- Updates the
titlefrontmatter - Sets
updated-atto today’s date - Optionally renames the file (if “Sync filename with task title” is enabled)
Press Escape to cancel without saving.
The standard Obsidian behaviour of renaming the file is intercepted—your edits go to the frontmatter instead.
Filename Sync
Section titled “Filename Sync”Enable Sync filename with task title to rename files when editing the inline title:
- Filenames are converted to kebab-case (“Buy Groceries” →
buy-groceries.md) - Obsidian updates all wikilinks automatically
- Duplicate names get a number suffix (
buy-groceries-2.md)
When It Applies
Section titled “When It Applies”The inline title replacement only activates when all of these conditions are met:
- The file is in your configured tasks directory
- The file isn’t matched by any pattern in Ignored files
- The file has valid frontmatter with both
titleandstatusfields
For all other files, Obsidian’s normal inline title behaviour applies—edits will rename the file as usual.