Kanban插件详细指南

Obsidian Kanban 插件 - 看板任务管理完全指南

#resource / obsidian #type / howto #status / evergreen

[!info] related notes


Kanban 插件详细指南

核心功能:看板管理、拖拽操作、实时同步、多视图
难度级别:⭐⭐
推荐指数:⭐⭐⭐⭐⭐
必装程度:强烈推荐(项目管理必备)


功能概览

核心特性

功能说明优势
看板视图列表化任务管理直观展示工作流
拖拽操作卡片在列间移动流畅的交互体验
任务嵌套任务下添加子任务细粒度管理
标签系统给卡片添加标签分类与筛选
优先级视觉化优先级显示聚焦重要任务
截止日期截止日期跟踪时间管理
实时同步修改立即保存无需手动保存

Kanban 看板结构

┌─────────────┬──────────────┬────────────────┐
│   To Do     │   In Progress │    Done       │
├─────────────┼──────────────┼────────────────┤
│ ┌─────────┐ │ ┌──────────┐ │ ┌────────────┐ │
│ │ 任务 1   │ │ │ 任务 3   │ │ │ 任务 5     │ │
│ └─────────┘ │ └──────────┘ │ └────────────┘ │
│             │              │                │
│ ┌─────────┐ │ ┌──────────┐ │                │
│ │ 任务 2   │ │ │ 任务 4   │ │                │
│ └─────────┘ │ └──────────┘ │                │
└─────────────┴──────────────┴────────────────┘

安装与配置

安装

  1. Settings → Community plugins → Browse
  2. 搜索 “Kanban”
  3. 安装并启用

创建看板

方法 1:新建看板笔记

1. 在想要的位置新建笔记
2. 添加看板代码块:
   ~~~kanban
   {
     "lanes": [
       {"id": "1", "title": "To Do"},
       {"id": "2", "title": "In Progress"},
       {"id": "3", "title": "Done"}
     ]
   }
   ~~~
3. 自动加载看板视图

方法 2:快速看板创建

右键笔记 → Kanban: Create new board
自动生成初始看板模板

基本配置

Settings → Kanban

## 显示选项
Show Checkboxes: true              # 显示复选框
Show File Links: true              # 显示文件链接
Show Tag Icons: true               # 显示标签图标
Show Relative Date in Cards: true  # 显示相对日期

## 交互选项
Archive Cards: true                # 支持归档卡片
Allow Editing: true                # 允许编辑卡片
Allow Adding Cards: true           # 允许添加卡片

快速开始

创建基础看板

最简单的看板

~~~kanban
{
  "lanes": [
    {
      "id": "todo",
      "title": "To Do"
    },
    {
      "id": "progress",
      "title": "In Progress"
    },
    {
      "id": "done",
      "title": "Done"
    }
  ]
}
~~~

添加任务卡片

在看板中添加卡片

1. 点击"添加卡片"按钮
2. 输入任务标题
3. 或直接在卡片上拖拽添加

[视觉添加]
To Do 列 → [+] 按钮 → 输入任务 → Enter

管理卡片

操作方法
编辑卡片点击卡片 → 编辑内容
删除卡片右键卡片 → 删除
移动卡片拖拽卡片到其他列
复制卡片右键卡片 → 复制

工作流示例

场景 1:敏捷开发工作流

看板设置

To Do → In Progress → Code Review → Done

工作流程

1. 产品经理在 "To Do" 列添加新功能
2. 开发者选择任务 → 拖到 "In Progress"
3. 完成开发 → 拖到 "Code Review"
4. 审核通过 → 拖到 "Done"

场景 2:个人任务管理

看板设置

Backlog → This Week → Today → Done

工作流程

1. 新任务进入 Backlog
2. 本周规划:Backlog → This Week
3. 每日工作:This Week → Today
4. 完成:Today → Done
5. 周末统计:Done 列的任务

场景 3:内容创作工作流

看板设置

Ideas → Planning → Writing → Editing → Published

工作流程

Ideas:灵感收集
Planning:大纲规划
Writing:内容创作
Editing:编辑校对
Published:发布存档

场景 4:学习进度追踪

看板设置

Not Started → Learning → Review → Mastered

工作流程

1. 添加学习主题到 "Not Started"
2. 开始学习 → "Learning"
3. 复习备考 → "Review"
4. 掌握完成 → "Mastered"

高级特性

1. 添加优先级标记

~~~kanban
{
  "lanes": [
    {
      "id": "1",
      "title": "To Do"
    }
  ],
  "cards": [
    {
      "id": "1",
      "title": "🔴 高优先级任务",
      "desc": "必须今天完成"
    },
    {
      "id": "2",
      "title": "🟡 中优先级任务",
      "desc": "这周完成"
    },
    {
      "id": "3",
      "title": "🟢 低优先级任务",
      "desc": "有时间再做"
    }
  ]
}
~~~

2. 添加标签与分类

# 在卡片中使用标签

拖拽卡片时自动保存
标签格式:#tag1 #tag2

例如:
- #bug #critical
- #feature #backlog
- #documentation #low-priority

3. 添加截止日期

在卡片描述中添加:
Due: 2025-12-15

Deadline: 2025-12-15

Kanban 会自动显示日期

4. 卡片分组

按优先级分组

使用标签分组卡片:
- 在卡片中添加标签 #p1 #p2 #p3
- 便于按优先级查看

常见问题

Q1:如何从笔记链接添加卡片?

方法 1:使用文件链接

~~~kanban
{
  "cards": [
    {
      "id": "1",
      "title": "[[笔记名称]]",
      "desc": "关联的详细笔记"
    }
  ]
}
~~~

方法 2:引用任务笔记

在 Kanban 中链接到包含任务详情的笔记
点击卡片 → 打开关联笔记

Q2:如何导出看板为列表?

导出方法

1. 右键看板 → Export as list
2. 或手动复制卡片内容到笔记

Q3:如何在多个设备间同步看板?

同步方案

1. 使用 Obsidian Sync 自动同步
2. 或使用 Git 版本控制

看板数据存储在 Markdown 中,自动同步

Q4:卡片太多,看板变得混乱?

优化方案

1. 按优先级排序卡片
2. 使用标签筛选卡片
3. 创建多个看板(按项目/周期)
4. 归档已完成的卡片

Q5:如何在移动设备上使用看板?

移动方案

Obsidian Mobile 版支持 Kanban
1. 同步到移动设备
2. 使用 Obsidian 手机应用打开
3. 拖拽操作(触屏支持)

集成应用

Kanban + Daily Note

Daily Note 中嵌入当日看板

---
title: 2025-12-08 日常任务
---

# 今日任务

~~~kanban
{
  "lanes": [
    {"id": "1", "title": "早上"},
    {"id": "2", "title": "下午"},
    {"id": "3", "title": "晚上"},
    {"id": "4", "title": "完成"}
  ]
}
~~~

Kanban + Task Plugin

结合 Tasks 插件:
- 在 Kanban 中管理任务流转
- 在 Kanban 卡片中添加待办清单
- 完成后自动更新状态

Kanban + Dataview

// 在 Dataview 中查询 Kanban 状态
const projects = dv.pages("#project");
dv.table(
  ["项目", "状态"],
  projects.map(p => [p.file.link, p.kanban_status])
);

最佳实践

  1. 合理设计列

    • 3-5 列为最优(Too Do, In Progress, Done)
    • 明确每列的含义
  2. 定期整理看板

    • 每周回顾:检查 Done 列
    • 每天清理:删除过期任务
  3. 使用颜色编码

    • 通过标签显示优先级
    • 🔴 红色 = 高优先级
    • 🟡 黄色 = 中优先级
    • 🟢 绿色 = 低优先级
  4. 添加描述信息

    • 卡片描述保留重要信息
    • 链接相关笔记
  5. 备份与版本控制

    • 使用 Git 跟踪看板历史
    • 重要看板定期备份

多层级看板

项目级看板

# 项目管理看板

~~~kanban
{
  "lanes": [
    {
      "id": "planning",
      "title": "规划"
    },
    {
      "id": "development",
      "title": "开发"
    },
    {
      "id": "testing",
      "title": "测试"
    },
    {
      "id": "release",
      "title": "发布"
    }
  ]
}
~~~

周计划看板

# 本周计划 - 2025-12-08 to 2025-12-14

~~~kanban
{
  "lanes": [
    {"id": "mon", "title": "Monday"},
    {"id": "tue", "title": "Tuesday"},
    {"id": "wed", "title": "Wednesday"},
    {"id": "thu", "title": "Thursday"},
    {"id": "fri", "title": "Friday"},
    {"id": "done", "title": "Completed"}
  ]
}
~~~

故障排除

看板无法显示

检查步骤:
1. 确认插件已启用
   Settings → Community plugins → Kanban ✓

2. 检查代码块语法
   ~~~kanban(确保正确)
   ```kanban(错误,应该是 ~~~)

3. 检查 JSON 格式
   使用在线 JSON 验证器检查配置

4. 重新加载笔记
   Ctrl+R 刷新

卡片无法拖拽

解决方案:
1. 确认 "Allow Editing" 已启用
2. 确认没有禁用拖拽功能
3. 关闭其他干扰插件
4. 重启 Obsidian

📚 相关文档


创建于 2025/12/8 更新于 2026/5/27