Taskdown

VS Code commands for working with Taskdown Markdown files.

Done

Place the cursor on an unchecked Markdown task and run Taskdown: Done from the Command Palette. The default shortcut is Alt+D (Option+D on macOS). Multiple cursors can complete multiple tasks at once.

Supported task forms include:

- [ ] List task

1. [ ] Ordered task

## [ ] Heading task

New Task

Run Taskdown: New Task or press Alt+T (Option+T on macOS) to append - [ ] to the end of the Markdown document. The cursor moves after the task marker so the task can be entered immediately.

H2

Place the cursor on a checklist task inside a # Project: block and run Taskdown: H2, or press Alt+H (Option+H on macOS). The task is promoted to an H2 task and moved to the end of that project. Its completion state and trailing Taskdown annotation are preserved.

Synchronization

Run Taskdown: Set Todoist API Key once to store the API key in VS Code's SecretStorage. Taskdown checks the key with a read-only Todoist request before storing it.

Run Taskdown: Check Todoist API Key to check the currently stored key without changing it.

Saving a Markdown document syncs that file to Todoist. The extension also pulls Todoist changes when the VS Code window regains focus, with a five-minute minimum interval. Run Taskdown: Sync from Todoist to pull immediately. Pulling is skipped while the workspace contains unsaved Markdown.

Synchronization writes are saved through VS Code's normal save pipeline. To format them with the configured Markdown formatter, enable format on save:

"[markdown]": {
  "editor.defaultFormatter": "your.formatter-extension",
  "editor.formatOnSave": true
}

Automatic behavior can be configured with taskdown.syncOnSave, taskdown.syncFromTodoistOnFocus, and taskdown.syncFromTodoistIntervalMinutes.

Open the Taskdown channel in the Output panel to inspect synchronization starts, results, skipped operations, missing API key notices, and errors. API key values are never written to the channel.

For difficult synchronization investigations, taskdown.trace.dangerouslyVerbose writes unredacted domain results and related traces to the same channel. This can expose Markdown contents, file paths, task details, and external identifiers, and may produce substantial output. Enable it only temporarily and reload the VS Code window after changing it.

Development

From the repository root:

pnpm --filter taskdown build
code --extensionDevelopmentPath="$PWD/entrypoints/extension"

Run pnpm --filter taskdown package to create a local VSIX.