This extension provides a Kanban board for managing tasks within markdown files in your VS Code workspace.
Features
Kanban Board: Visualize your tasks in a Kanban board format with columns
Task Synchronization: Automatically sync tasks between markdown files and the Kanban board.
Task Archiving: Archive old tasks from the Done column to keep your board clean.
Task Management: Move tasks between columns
Status Bar Integration: Display the number of TODOs in the status bar and provide a quick link to the Kanban board.
Tag Task with Color: Declare a color to a folder in colors.json and it will show in the view.
Add quick tasks: Add Tasks from the kanban view. These tasks will be saved in a seeperate (quicktasks.md) file.
Tipps, Tricks and Explaination
Note files
Tasks need to be opened with [ ] in note markdown files.to be collected and synced. If you close a task in the note file with [X]and run the collector the task will be moved to the done bucket in the Board.
Keep your tasks short.
Kanban View
Open the view with kanban view. Then collect your open tasks with the collector.
Drag the tasks into new buckets. If you move it to 'done' it will be closed and the status will sync to the source note file. The status also syncs if you move it from bucket 'done' to any other 'bucket'.
On every task is a small button to move it to done quickly.
On the task is the path to the source note file. Click on it and VS Code will jump into the file.
Kanban.md
The file will be created if it does not exist.
You can add buckets with ### <Bucket>. Bucket ### Backlogneeds to start the file and the last bucket has to be ### Done.
Collector
The collector searches your workspace for new tasks to add and will add them to the backlog. Also if you have an open task in your kanban but it is closed in your note it will be closed in the kanban after the collector ran.
If you change the name of the task in your note file it will be added as a new task and the old version will stay in the kanban view!
Recommendation:
Close task in note
run collector.
Delete task in note
Add a new one. Run collector
Archiver
Set mdkanban.maxBucketDone in Settings to the number of tasks you want to keep in Done. The Archiver will move to other to a csv file and adds the date of the archive to the task.
Requirements
Visual Studio Code version 1.97.0 or higher.
Extension Settings
mdkanban.maxBucketDone: Number of tasks remaining in the 'Done' bucket after archiving. Default is 10
Known Issues
Buckets need to be formatet with ### <Bucket>.
kanban.md has to start with bucket Backlog
kanban.md has to end with bucket Done
Task synchronization may not work correctly if the markdown files are not formatted properly.
kanban.md, archive_tasks.csv, colors.json and quicktasks.md have to be in root of workspace
