Weekly Kanban - Markdown Sync

Weekly Kanban is a VS Code extension for managing weekly tasks in Markdown with a visual Kanban board. English first, with short Japanese notes where helpful.

Markdown is your source of truth, and the board stays in sync in real time. Markdown を真実の情報源として維持しながら、Kanban で直感的に操作できます。

Features

• Markdown-first workflow with Frontmatter + sections
• Visual board with ToDo, Doing, and Done columns
• Real-time two-way sync between Markdown and Kanban view
• Drag-and-drop card movement and task editing
• Keyboard navigation: Arrow keys, Enter, Delete
• Accessibility support: WCAG 2.1 AA target, high-contrast ready

Quick Start

1. Open a workspace with a weekly Markdown file, such as weekly-2026-w27.md.
2. Run Weekly Kanban: Open Kanban View from Command Palette.
3. Edit tasks in either Markdown or the Kanban board.

Markdown Example

Use this sample file as a starting point:

• weekly-sample.md

Commands

• Weekly Kanban: Open Kanban View
• Weekly Kanban: Open Weekly File
• Weekly Kanban: Create Weekly File
• Weekly Kanban: Save Weekly File

Keyboard Shortcuts

• Arrow keys: move focus between cards
• Enter: toggle completion state
• Delete: remove selected card

Known Limitations

• One board per Markdown file (single-file scope)
• No multi-file aggregation in v0.1
• No automatic conflict resolution in concurrent edits
• Markdown-side state is prioritized during conflict scenarios

Support

• Issues: https://github.com/hikos/weekly_kanban_vscode_extension/issues
• User Manual: doc/User_Manual.md

Development

npm install
npm run build
npm run lint
npm test

Requirements

• VS Code 1.85.0+
• Node.js 18+

License

MIT