TaskMD

日本語 | English

Markdown-based, local-first Kanban task management tool.

Overview

TaskMD is a simple task management tool that manages Kanban boards using Markdown files without a database.

Features

• Markdown Format: All board data is saved and loaded as Markdown files
• YAML Frontmatter: Board and task metadata is managed via YAML frontmatter
• Kanban Board: Create columns including Todo and Done (Todo and Done cannot be deleted)
• Tag Management: Add, edit, delete tags and assign them to tasks
• Task Linking: Link tasks with Markdown format [label](./taskId)
• Drag & Drop: Easily move tasks between columns
• Completely Local: No server required, works entirely in the browser

Markdown Format

Board File

---
id: abc123xyz789
name: Project Management
createdAt: 2026-03-11T10:00:00.000Z
updatedAt: 2026-03-11T15:30:00.000Z
---

# Project Management

## Todo

- [Requirements Definition](./tasks/def456uvw012.md)
- [Design Creation](./tasks/ghi789rst345.md)

## In Progress

- [Database Design](./tasks/jkl012mno678.md)

## Done

- [Environment Setup](./tasks/mno345pqr901.md)

Task File

---
id: def456uvw012
title: Create Requirements Document
createdAt: 2026-03-11T10:00:00.000Z
updatedAt: 2026-03-11T15:30:00.000Z
startedAt: 2026-03-11T14:00:00.000Z
completedAt: 2026-03-12T16:00:00.000Z
---

Create the project requirements document.

- [ ] Create user list
- [ ] Organize functional requirements
- [ ] Define non-functional requirements

This task is related to [Design Mockup Creation](./ghi789rst345).

Tag Features

Tag Management

1. Click the "Tags" button on the board page
2. Add, edit, and delete tags
3. Tags are saved in the board's available-tags frontmatter

Assigning Tags to Tasks

1. Click "Edit" on the task detail page
2. Select from available tags (multiple selection allowed)
3. Save to assign tags to the task

Filtering by Tags

Use the tag filter on the board page to display only tasks with specific tags.

Usage

Start Development Server

npm run dev

Build

npm run build

File Structure

Boards are stored in the kanban/ directory at the project root:

kanban/
├── board-name/
│   ├── board-id.md          # Board file
│   └── tasks/
│       ├── task-1.md        # Task files
│       ├── task-2.md
│       └── ...

Note: All board data is stored in the kanban/ directory. When you run TaskMD locally, it creates and reads files from this directory.

Board Frontmatter Fields

• id: Unique ID for the board
• name: Board name
• createdAt: Creation date (ISO 8601 format)
• updatedAt: Update date (ISO 8601 format)
• available-tags: List of available tags (JSON array)

Task Frontmatter Fields

• id: Unique ID for the task
• title: Task name
• createdAt: Creation date (ISO 8601 format)
• updatedAt: Update date (ISO 8601 format)
• startedAt: Start date (optional)
• completedAt: Completion date (optional)

Task Linking Feature

To link tasks, write in Markdown link format [label](./taskId) in the task content.

Example:

---
id: def456uvw012
title: Design Creation
createdAt: 2026-03-11T10:00:00.000Z
updatedAt: 2026-03-11T15:30:00.000Z
---

This task is related to [Requirements Definition](./abc123def456).

Clicking a link will display the linked task details in a modal.

Technology Stack

• SvelteKit
• TypeScript
• Tailwind CSS
• marked (Markdown parser)

Data Flow

1. Create New: Click "New Board" button → Enter name → Board created with Todo and Done columns
2. Load: Click "Boards" button → Select existing board
3. Edit: Add, edit, delete, and move tasks
4. Save: Automatically saved as Markdown files

License

MIT