Taskdn

by Danny
5
4
3
2
1
Score: 30/100

Description

An Obsidian plugin for Taskdn, a file-based task management system that stores tasks as Markdown files with YAML frontmatter.

Reviews

No reviews yet.

Stats

1
stars
155
downloads
0
forks
4
days
4
days
4
days
3
total PRs
0
open PRs
0
closed PRs
3
merged PRs
2
total issues
2
open issues
0
closed issues
62
commits

Latest Version

4 days ago

Changelog

Requires Obsidian 1.13 or later.

Improvements

  • Settings now appear in Obsidian's settings search and apply immediately. "Tasks directory" has a folder picker.
  • Widgets work in pop-out windows.
  • Widgets update when a task's project or area changes. In Reading mode they update in place, so the view no longer jumps.
  • Clicking just after a task widget and pressing Enter starts a new checkbox line.
  • Ready task notes have a neutral left border, so they're distinguishable from done tasks.

Fixes

  • Task widgets sometimes rendered as blank lines.
  • Clicking into a task's inline title and away again (or pressing Escape) renamed the file to the task title.
  • Editing an inline title could save it twice.
  • Turning off "Use task title as inline title", or disabling the plugin, now restores the filename straight away.
  • completed-at and updated-at could be a day off around midnight outside UTC.
  • Clicking the desktop app button no longer moves the cursor.

Full details: #3

README file from

Github

Obsidian Taskdn

An Obsidian plugin for Taskdn, a file-based task management system that stores tasks as Markdown files with YAML frontmatter.

Taskdn keeps everything as plain files on disk, so you can work with your tasks in Obsidian, the Taskdn desktop app, CLI tools, or AI agents. This plugin turns wikilinks to task files into interactive widgets.

Features

Wikilinks to task files become clickable widgets with:

  • Checkbox to toggle completion (switches between ready and done)
  • Task title (click to open the file)
  • Project, area, and due/defer dates when present
  • Coloured left border showing status (blue = inbox, yellow = in-progress, red = blocked, etc.)

When you put a task link in a bullet list (- [[my-task]]), it behaves like a native Obsidian checklist—completing it strikes through the whole line.

You can also right-click any checklist item (- [ ] Do something) to convert it into a Taskdn task file.

Inline Title Replacement

When Obsidian's "Show inline title" setting is enabled, you can optionally have task files display their human-readable title frontmatter instead of the filename.

How it works:

  • Enable "Use task title as inline title" in the plugin settings
  • When viewing a task file, the inline title shows the title frontmatter (e.g., "Buy groceries") instead of the filename (e.g., "buy-groceries")
  • Editing the inline title updates the title frontmatter and sets updated-at to today's date
  • A coloured left border appears on the document indicating the task's status

This only applies to valid Taskdn task files—documents in your tasks directory with both title and status frontmatter that aren't in the ignored files list. For all other files, Obsidian's normal inline title behaviour is unchanged.

Optional filename sync: Enable "Sync filename with task title" to also rename the file when you edit the inline title. The filename is converted to kebab-case (e.g., "Buy Groceries" → buy-groceries.md), and Obsidian automatically updates any links to the file.

Prerequisites

  1. Obsidian 1.13 or later
  2. WikiLinks must be enabled (Settings → Files & Links → "Use [[Wikilinks]]")
  3. You need a tasks folder with files following the Taskdn spec

Installation

  1. Settings → Community plugins → Browse
  2. Search for "Taskdn"
  3. Install and enable

To install manually, download main.js, manifest.json and styles.css from the latest release into .obsidian/plugins/taskdn/ in your vault, then enable Taskdn in Settings → Community plugins.

Configuration

In Settings → Taskdn:

  • Tasks directory – where your task files live (default: tasks)
  • Default status – status for newly converted tasks (default: inbox)
  • Show desktop app button – adds a button to open tasks in the Taskdn desktop app
  • Ignored files – task files to exclude from widget rendering (one pattern per line, supports * wildcard). Paths are relative to the tasks directory, e.g. archive/* or *-template
  • Use task title as inline title – display the title frontmatter instead of the filename in Obsidian's inline title (requires Obsidian's "Show inline title" to be enabled)
  • Sync filename with task title – when editing the inline title, also rename the file to match (in kebab-case)

Usage

Link to any task file in your tasks directory:

- [[my-task]]
Check out [[another-task]] for details.

Works in both Live Preview and Reading Mode.

Development

Requires Bun 1.4.4 or later.

git clone https://github.com/dannysmith/obsidian-taskdn.git
cd obsidian-taskdn
bun install          # Also enables a pre-commit hook that runs `bun run check`
bun run dev          # Watch build
bun run build        # Production build
bun run check        # Types, Obsidian's lint rules, formatting and tests
bun run fix          # Auto-fix lint and formatting
bun run test-vault   # Create or reset a test vault in test-vault/

To try your changes, open test-vault/ as a vault in Obsidian. The build is symlinked into it, so reload the plugin after each build. See AGENTS.md for architecture notes.

License

MIT