Skip to content
| Marketplace
Sign in
Visual Studio Code>Visualization>Tasks for MarkdownNew to Visual Studio Code? Get it now.
Tasks for Markdown

Tasks for Markdown

HastyCapybara

|
67 installs
| (0) | Free
Obsidian Tasks-style task management for Markdown in VS Code and Cursor: queries, rendered view, kanban, calendar, recurrence and notes. Inspired by and compatible with the Obsidian Tasks plugin.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Tasks for Markdown

VS Code Marketplace Open VSX npm: tasks-cli npm: tasks-api License: MIT

Obsidian Tasks-compatible task management for Markdown files in VS Code and Cursor.

Website · Korean README

This extension started from the Tasks plugin for Obsidian. It rebuilds that plugin's task syntax, query language and years of careful design for VS Code and Cursor. Thank you to its authors and contributors — see Credits.

Why Tasks for Markdown

Your notes stay plain Markdown Tasks are ordinary checklist lines in the Obsidian Tasks syntax — no database, no lock-in. The same files work in Obsidian, on GitHub and in any editor.
Your AI agent can manage them A built-in MCP server lets Claude Code, Cursor's agent, Claude Desktop or VS Code's agent mode query, create, complete and annotate tasks when you ask in plain language.
Other tools can build on it A versioned public API, a command surface, a typed npm package, a CLI and a Node library. Other extensions, scripts and CI jobs read and write the same tasks safely.
- [ ] Write the report #work ⏫ 🔁 every week 🛫 2026-09-20 ⏳ 2026-09-22 📅 2026-09-25
  - Ask finance for the Q3 numbers
- [x] Tidy meeting notes ✅ 2026-09-21

The extension indexes every - [ ] line in the workspace. You can see, query and complete tasks wherever you are: the editor, a sidebar, a kanban board, a calendar or the Markdown preview. Completing a task rewrites the line in the file. It adds a done date, and for a recurring task it adds the next instance.

Four Shortcuts

You don't have to type the boxes and dates by hand. In any Markdown file:

Make a checkbox
Cmd+Shift+C (macOS) / Ctrl+Shift+C (Windows, Linux) turns the current line into - [ ] …. A bullet keeps its marker; on a task line it removes the box.

Cmd+Shift+C turns a plain line and then a bullet into tasks

Mark it done
Option+C (macOS) / Alt+C (Windows, Linux) on a task line adds ✅ and today's date. A recurring task gets its next occurrence.

Option+C completes a task, then a weekly task, which gets its next date

Create or edit in a form
Option+Shift+C (macOS) / Alt+Shift+C (Windows, Linux). On an empty line it starts a new task; on a task line it edits that task. Priority, dates in plain words (next fri), tags and repeat in one place.

Option+Shift+C opens the form; a task with priority, due date and tag is created

Switch to the rendered view
Cmd+Shift+R (macOS) / Ctrl+Shift+R (Windows, Linux) shows the note as a page with clickable checkboxes and live query results; press it again to go back to the source.

Cmd+Shift+R opens the rendered view, a task is ticked there, and Cmd+Shift+R returns to the source with the line marked done

All keys can be changed with Tasks: Keyboard shortcuts; the full list is under Commands.

Highlights

  • Same syntax as Obsidian Tasks — emoji and Dataview fields, written in Obsidian's field order, so files stay interchangeable.
  • Editor assistance — auto-suggest with natural-language dates (English and Korean), CodeLens, hover cards, overdue highlighting, diagnostics with quick fixes.
  • Sidebar — Today, Next 7 days, Overdue, In progress, Blocked, All open, Done; saved queries with grouped results.
  • Query language — the Obsidian Tasks query language in ```tasks blocks, saved queries and a visual query builder.
  • Recurrence, statuses, dependencies — 🔁 every month on the last, custom statuses with presets, 🆔/⛔ dependencies with blocked detection, urgency score.
  • Rendered view — an interactive preview: tick, edit, postpone, add notes, type into quotes, show or hide columns, live query results (Cmd/Ctrl+Shift+R).
  • Notes — indented bullets under a task are its notes; add them from the rendered view with 💬.
  • More views — create/edit dialog, kanban, calendar, weekly statistics, archive, daily notifications.
  • AI and automation — MCP server for AI agents, public extension API, commands, CLI and library (see Use it with AI and Extend it).

Getting started

New here? Open the Get Started guide in VS Code (in Cursor: Tasks: Open Get Started guide from the Command Palette). The guide also opens by itself the first time.

  1. Open a folder with Markdown files. Every - [ ] line in it becomes a task, and the Tasks icon appears in the Activity Bar.
  2. Create tasks. Write a checklist line such as - [ ] Write the report 📅 2026-09-25, or use the four shortcuts: checkbox, done, create/edit, rendered view.
  3. Filter with a query block, then view the note. A ```tasks block lists the tasks that match its lines; Cmd/Ctrl+Shift+R opens the note in the rendered view with the results in place. (VS Code's own Markdown preview shows the results too, but its checkboxes are display-only.) Common query lines: Query syntax.
```tasks
not done
due before next week
sort by urgency
group by filename
```

See it in action

Write tasks with help. Auto-suggest offers fields as you type, and natural-language dates like next fri become real dates.

Typing a task: auto-suggest for the due date, "next fri" becomes 2026-10-09

Work in the rendered view. Tick checkboxes, add notes with 💬, add tasks below a row with Enter or + (one after another), type into a blockquote by clicking it, and show or hide columns. Query blocks update live.

Rendered view: adding a note, ticking a task, hiding and restoring a column

Plan on a board and a calendar. Drag cards between status columns, or drag a task to another day to reschedule it.

Kanban: a card moves to In Progress and another to Done; calendar: a task is dragged to a new date

Use it with AI

Tasks for Markdown ships an MCP server, so any MCP-capable AI agent can read and change your tasks as tools: Claude Code, Cursor's agent, VS Code's agent mode, Claude Desktop. In VS Code and Cursor it is connected the moment you install the extension; then ask in plain language. The recording below is a real Claude Code session. The note in the editor updates while the agent works.

Claude Code answers "What is overdue?", marks the task done and adds a note; the file updates live

Connect — nothing to install; the server runs on the editor's own Node:

  • VS Code (agent mode) and Cursor: connected automatically when the extension is installed, one server per workspace folder (tasksmd.mcp.autoRegister, on by default; not in untrusted workspaces).
  • Claude Code and Claude Desktop: run Tasks: Connect AI agents (MCP) and pick them. Claude Code is added for this project on this computer (claude mcp add-json --scope local); Claude Desktop's config file is updated after you confirm, with a backup and every other server kept (quit Claude Desktop first — while it runs it can write its old settings back). If either is installed but not connected, the extension offers to connect it when it starts. Claude Desktop asks before each tool call; to stop that for lookups, set the read-only tools to Always allow in its connector settings (+ → Connectors → Manage connectors → tasks).
Without the extension (another machine, CI): the npm package

Node.js 18+ is needed, because the server runs from npm with npx.

# Claude Code, in your notes folder
claude mcp add tasks -- npx -y @hastycapybara/tasks-cli mcp --root "$PWD"

Cursor — .cursor/mcp.json:

{ "mcpServers": { "tasks": { "command": "npx", "args": ["-y", "@hastycapybara/tasks-cli", "mcp", "--root", "${workspaceFolder}"] } } }

VS Code (agent mode) — .vscode/mcp.json:

{ "servers": { "tasks": { "type": "stdio", "command": "npx", "args": ["-y", "@hastycapybara/tasks-cli", "mcp", "--root", "${workspaceFolder}"] } } }

Claude Desktop — claude_desktop_config.json, with the absolute path of your notes folder:

{ "mcpServers": { "tasks": { "command": "npx", "args": ["-y", "@hastycapybara/tasks-cli", "mcp", "--root", "/path/to/notes"] } } }

Ask things like:

  • "What is overdue? Mark the vendor contract review done and add a note: Legal approved clause 3."
  • "Plan my week: list everything due before Sunday, sorted by urgency."
  • "Postpone all #home tasks due today to Saturday."
  • "Create a task to renew the passport, high priority, due next Friday."

What the agent can do: query with the full query language, get and create tasks, update fields, set status, postpone, add notes, remove, and explain a query. The agent reads a syntax reference first, so the lines it writes are valid Obsidian Tasks syntax. Every write carries the exact text of the line it read, and the write is refused if the line changed meanwhile. Your edits are never overwritten by an agent working from an old copy. Full tool list: MCP server.

Use it from the terminal

Tasks: Install 'tasksmd' terminal command (or the button in the Get Started guide) adds a tasksmd command to every terminal — no Node.js or npm, it runs on the editor's own Node and updates with the extension.

  • Check without opening the editor: what is due today, overdue, next.
  • Quick changes: add, complete, postpone, add a note.
  • Scripts and automation: a morning summary, a git hook that warns about overdue release tasks, a Raycast / Alfred / Shortcuts action; --json for tools like jq.
  • Terminal AI agents: Claude Code, Codex and others that run shell commands can use it directly.
  • Same rules as the editor: Obsidian Tasks syntax, done dates, the next occurrence of recurring tasks, your settings; --expect refuses to change a line edited meanwhile.
tasksmd query "not done
due before today
sort by due"                                                   # what is overdue?
tasksmd add "- [ ] Call the bank 📅 2026-10-08" --file inbox.md   # add (creates the file)
tasksmd postpone inbox.md:1 "next monday"                       # lines are 1-based
tasksmd done inbox.md:1                                         # ✅ date, next occurrence
tasksmd query "due today" --json | jq '.matched'

Extend it

Tasks for Markdown is built to be built on. Another extension, a keybinding, a script or a CI job can use the same tasks through a stable, versioned public API. You don't need to parse Markdown yourself.

What you could build:

  • a time tracker that starts a timer when a task moves to In progress (events.onDidChangeStatus)
  • a status bar counter or dashboard of overdue work (query.run + events.onDidChangeTasks)
  • a bridge that posts completed tasks to a team chat or closes an issue (events.onDidCompleteTask)
  • a daily report in CI that fails the build when release tasks are overdue (the CLI)
  • your own views on top of the same index: timelines, focus lists, reviews
import type { TasksExtensionExports } from '@hastycapybara/tasks-api';

const ext = vscode.extensions.getExtension<TasksExtensionExports>('HastyCapybara.tasks-for-markdown');
const tasks = (await ext!.activate()).getAPI(1, { extensionId: 'me.my-extension' });

const r = await tasks.query.run('not done\ndue before tomorrow\nsort by urgency');
tasks.events.onDidChangeStatus(({ before, after }) => console.log(after.description, before.status.name, '→', after.status.name));
if (tasks.features?.includes('notes.add')) await tasks.edit.addNote(r.tasks[0], 'Started');
Surface For
Extension API getAPI(1) other VS Code/Cursor extensions query, edit (create, update, setStatus, postpone, addNote, batch…), events, ui, feature detection with features / info()
Commands tasksmd.api.* keybindings, macros, extensions in any language every API method as a command with JSON arguments
@hastycapybara/tasks-api TypeScript type definitions only (no runtime code)
tasksmd command terminal, scripts, AI agents tasksmd query, add, done, note, info, … and the MCP server. Tasks: Install 'tasksmd' terminal command installs it from the extension (no npm); on machines without the editor use @hastycapybara/tasks-cli
Task links other apps, chat, AI answers <scheme>://hastycapybara.tasks-for-markdown/open?path=…&line=… and /query?text=…; ui.link(ref) makes one
@hastycapybara/tasks-core Node programs the parser, query engine and recurrence as a library

The API version stays 1 while features are only added, so your extension keeps working across updates. Writes are confirmed once per caller by default (tasksmd.api.writePolicy), errors are plain { code, message } objects, and stale writes are refused. Read the public API reference.

Query syntax

A ```tasks block holds one instruction per line. Every line in the result must pass all filter lines (they combine with AND). It is the Obsidian Tasks query language, so the same block works in Obsidian.

Purpose Lines you can write
Status not done · done · status.type is IN_PROGRESS
Dates due today · due before tomorrow · due this week · due next week · happens on or before today · done after last week · no due date · has due date
Priority priority is high · priority is above medium
Text, tags, files tags include #work · description includes report · path includes projects · heading includes Today
Recurrence and dependencies is recurring · is blocked (waits for an open task) · is blocking (an open task waits for it)
Combine (due today) OR (priority is high) · NOT (tags include #home) · AND, OR, NOT, XOR with parentheses
Order and grouping sort by urgency · sort by due reverse · group by filename · group by tags · limit 20
Display hide due date · short mode · show tree / hide tree (sub-tasks under their parent; on by default) · explain

Dates accept words such as today, next friday, in 2 weeks, ranges such as this month and 2026-W40, and exact dates. Full reference: filters, sorting and grouping in the Obsidian Tasks docs.

You don't have to write queries by hand. Tasks: Open query builder assembles one from drop-downs and shows the matching count as you go. The Explain CodeLens above a block shows how each line was understood.

Commands (Command Palette → "Tasks:")

Command Shortcut
Toggle task done Option+C (macOS) / Alt+C (Windows, Linux), on a task line
Add or remove checkbox Cmd+Shift+C (macOS) / Ctrl+Shift+C (Windows, Linux) — turns the line into - [ ] … (a bullet keeps its marker); on a task line it removes the box
Keyboard shortcuts (change any key) Tasks: Keyboard shortcuts opens the Keyboard Shortcuts editor filtered to this extension
Create or edit task Option+Shift+C (macOS) / Alt+Shift+C (Windows, Linux)
Quick search tasks Cmd/Ctrl+Shift+;
Set status / priority / due / scheduled / start / recurrence / dependencies, Postpone —
Open rendered view / edit Markdown source (toggle) — interactive preview with live ```tasks results Cmd+Shift+R (macOS) / Ctrl+Shift+R (Windows, Linux)
Rendered view as default editor (on/off) —
Open kanban board / calendar / statistics / query builder / query results (beside the editor, follows the cursor) —
Archive completed tasks… —
Insert query block, Explain query under cursor —
Connect AI agents (MCP), Install / Uninstall 'tasksmd' terminal command in PATH, Open Get Started guide —
Copy link to task, Copy link to query under cursor (links open the task from any app: vscode://hastycapybara.tasks-for-markdown/open?…) —
Load status preset…, Convert task format in this file… —

Settings (tasksmd.*)

Setting Default What it does
taskFormat emoji Format used when writing fields (emoji or dataview)
globalFilter "" Only lines containing this text (e.g. #task) are tasks
language auto Language of the extension's UI (auto, en, ko), independent of the editor's display language
mcp.autoRegister true Register the bundled MCP server with this editor's AI agent (VS Code agent mode, Cursor), one per folder; not in untrusted workspaces
removeGlobalFilterFromDescription true Hide the global filter text (e.g. #task) when showing descriptions; the file is not changed
include / exclude / respectGitignore / maxFileSizeKB What gets scanned
setDoneDate / setCancelledDate / setCreatedDate true / true / false Automatic ✅ ❌ ➕ dates
statuses 4 core statuses Custom checkbox symbols, names, next symbol and type
recurrence.insertPosition / idHandling / copyDependsOn / removeScheduledDate above / keep / true / false Next-instance behaviour
decorations.*, codeLens.mode / codeLens.position, autoSuggest.* off / lineEnd Editor assistance; task buttons at the end of the line (above = CodeLens), off by default — switch them on with the eye icon in the TASKS title bar
preview.enabled / preview.renderBadges true Markdown preview rendering
savedQueries [] Saved queries (also .tasks/queries/*.md)
query.allowFunctions false Allow by function JavaScript in queries (trusted workspaces only)
editModal.accessKeys / editModal.hiddenFields true / [] Edit dialog
notifications.* on, 09:00, 1 day Daily summary and due-soon digest, OS notifications
archive.file / afterDays / linkStyle Archive.md / 30 / wiki Archive command
calendar.newTaskFile "" File that receives tasks created from the calendar
query.showTree true Query results as a tree (sub-tasks under their parent); per block show tree / hide tree
decorations.strikeCancelled true Strike through cancelled tasks ([-]) in the editor; done tasks use decorations.strikeDone (off)
requireDueDate true Refuse new tasks without a due date (dialog, API, CLI, MCP) and warn in the editor
api.writePolicy confirm Writes through the public API: confirm once per caller / allow / deny
api.allowedWriters / api.batchLimit [] / 200 Extensions allowed to write without asking (filled in by the confirmation dialog); most operations in one API batch call
rendered.maxWidth 0 Max width (px) of the rendered column; 0 = full editor width (default)
rendered.sourceWhenNoTasks true With the rendered view as default editor, notes without tasks open in the text editor
rendered.markdownExtensions true Use what other extensions add to the built-in Markdown preview (Mermaid, math…) in the rendered view too
rendered.fieldsAlign columns Rendered view: fields in aligned columns (columns: status, description+priority+tags, due, created, everything else), at the right edge (right) or after the description (inline)
rendered.fontSize / rendered.lineHeight 14.5 / 1.6 Rendered view body font size (px) and line height
rendered.fieldStyle plain Task-line fields in the rendered view: as in the source (plain) or pill badges (badges)
calendar.fontSize 13 Font size (px) of tasks in calendar cells
calendar.fullScreen maximize Full screen button: maximize the editor group only, or window for the whole window
updateCheckUrl "" latest.json location for .vsix installs

Documentation

  • Public API (extension API, commands, library, CLI, MCP server)

  • Publishing guide (Korean) · Postmortems and incident log (Korean)

  • User guide (Korean)

  • Requirements · Design · Development checklist · Performance

Development

pnpm install
pnpm build              # extension + webview bundles
pnpm test               # unit tests (vitest)
pnpm test:integration   # runs a VS Code instance
pnpm package            # production build + .vsix + latest.json

Press F5 in VS Code to launch an Extension Development Host.

Credits

This extension would not exist without Obsidian Tasks. The task syntax, the query language and parts of the core logic (parser, recurrence, urgency) are ported from it (MIT license), and its documentation is the reference for how each feature behaves. Many thanks to Martin Schenck, who created the plugin, Clare Macrae, who has led it for years, and every contributor.

  • If you use Obsidian, try the original plugin: Tasks documentation · repository
  • You can support the original project: GitHub Sponsors (Clare Macrae)
  • Ported code and license notices: NOTICE.md
  • Licenses: THIRD_PARTY_NOTICES.md

This project is not affiliated with or endorsed by the Obsidian Tasks project or Obsidian (Dynalist Inc.).

License

MIT

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft