README file from
GithubTask Card
Your tasks, beautifully in view.
Turn Markdown checkboxes into interactive cards. Give each project its own color, break big plans into subtasks, and bring everything together in a list or a weekly matrix. Your tasks stay in your Obsidian notes.
Find Task Card in Obsidian · Get started · Download the latest release
A card for the whole plan. See the next step, the deadline, and the details together. Check off subtasks as you go; the progress bar keeps track. Expand a card to work on it, or collapse it to keep your notes light.
See your projects from every angle
Make room for what matters
The Eisenhower matrix gives your tasks four places: Do, Plan, Delegate, and Delete. Priority and due dates determine where each task appears, while project colors keep its context close. Compact rows keep the board tidy; hover for a full title or expand a task for its details.
Bring it all into one calm list
Gather tasks from different notes into a single view. Compact rows keep project dots and expand controls aligned; open individual tasks to see their subtasks and metadata alongside the rest of your list. Filter by project, label, priority, completion, schedule, or file. Complete a task from the results, or jump straight to its original note.
Keep writing in your notes
In Live Preview, dates, projects, and recurring schedules become compact metadata chips alongside your task text. Write a note, add a subtask, or edit a field in place; switch to Reading view when you want the full card.
Your theme. Your tasks.
Task Card takes its colors and typography from Obsidian, so it feels at home in the workspace you've already made your own.
Here are the same project cards in Minimal, Things, AnuPpuccin, Blue Topaz, Cupertino, and Obsidianite. Select a theme name to see its full-size window. The gallery mixes light and dark appearances; all six were checked in both modes.
Minimal, Things, AnuPpuccin, and Blue Topaz are among the most downloaded Obsidian themes. The screenshots above come from the actual plugin in Obsidian.
Start with one task
1. Write it. Tag it. Make it a card.
Add #TaskCard to an ordinary Markdown task:
- [ ] Book a weekend away #TaskCard
Switch to Reading view to see the card. Click it to expand, and click the checkbox when it's done. You can change the indicator tag in Task Card's settings.
2. Add the details as you need them
Click an attribute to edit it in place, or use + to add one. Cards support projects, priorities, due dates, scheduled time, duration, labels, and recurrence. Indented text becomes the description; indented checkboxes become subtasks.
- [ ] Plan a weekend in Kyoto #TaskCard #travel [project:: Japan Trip]
- [x] Save the train tickets
- [ ] Reserve a place by the river
- [ ] Map a quiet morning walk
For quick captures, use Quick add task from the command palette. It understands shorthand like Review the draft tomorrow 3pm for 1h !high #writing @Studio every week. When typing fields in a note, autosuggest helps you choose attributes and natural-language dates such as tomorrow or next fri 2pm.
3. Build a view of your own
Add a taskcard code block to any note. Use the visual editor to choose filters, or write a small query yourself:
```taskcard
project: ["Japan Trip"]
completed: [false]
editMode: false
```
Queries and the matrix need Dataview. Individual cards work without it.
Click Edit beneath a query to open its Filters, Scope, and View settings. For a list, List organization contains Group by for project or importance headings, and Sort by for original order, importance, due date, or task title. Completed last moves finished tasks to the end of each group. Click Save to apply these choices and return to the task view. The query remembers them without changing source task order. Existing queries keep their original flat list.
You can also set the options in the code block:
```taskcard
groupBy: "project"
sortBy: "priority"
completedLast: true
editMode: false
```
groupBy accepts none, project, or priority. sortBy accepts original, priority, due, or title. Undated tasks follow dated tasks when sorting by due date; equal keys keep their original order.
To make the same view a matrix, add display: "matrix":
```taskcard
completed: [false]
display: "matrix"
editMode: false
```
Beautiful cards. Ordinary Markdown.
Everything you add through a card stays readable in your notes. Projects and dates use Dataview inline fields, labels are normal hashtags, and task identity uses Obsidian block IDs.
Card titles and descriptions render Obsidian Markdown, including note links and aliases, emphasis, inline code, math, and embeds. Compact titles stay on one line; hover over a clipped title to read its full formatted text. Click a link to open its target, or edit the surrounding text to see the original Markdown.
- [ ] Book flights to Tokyo #travel #TaskCard [priority:: high] [due:: 2026-10-16] [project:: Japan Trip] ^tc-b3xr9d
- Keep your notes yours. Read and edit your tasks in Obsidian, a text editor, or on your phone. The task text remains useful if you remove the plugin.
- Work with existing tasks. Tasks from the Tasks plugin can use their existing emoji or Dataview fields; their format is preserved until you edit them through a card.
- Build a routine. Complete a recurring task and Task Card creates its next occurrence using the Tasks recurrence grammar.
- Stay close to your writing. Live Preview displays task metadata as compact chips while you edit the note.
Install Task Card
Open the Task Card community page. If installation is available, choose Add to Obsidian, then install and enable the plugin. Install Dataview as well if you want queries or the matrix.
For early access while a directory review is pending, add terryli710/Obsidian-TaskCard through BRAT.
For manual installation, download plugin-release.zip from the latest release, create .obsidian/plugins/task-card/ in your vault, and place main.js, manifest.json, and styles.css inside it. Enable Task Card under Settings → Community plugins.
A few useful answers
Does it work on mobile? Yes. Cards and queries support desktop and mobile Obsidian.
Do I need Dataview? Only for query lists and the matrix. Cards themselves work without it.
Can I migrate older Task Card tasks? Use Migrate legacy tasks to the new format to convert tasks from the older format into plain-text fields.
What if my theme needs a little attention? Open an issue with the theme name and a screenshot. The showcase covers several popular themes; individual theme customizations can still affect rendering.









