Obsidian Kanban 插件：在 Obsidian vault 中创建和管理基于 Markdown 的可视化看板。当用户需要在 Obsidian 中创建看板、添加/编辑卡片和列、设置日期标签、归档卡片、配置看板选项、或结合 Tasks 插件管理任务时使用此技能。
在 Obsidian vault 中以 .md 文件形式创建和管理可视化看板。看板数据完全以 Markdown 存储，兼容 Obsidian 同步和版本控制。
插件信息：作者 mgmeyers · 4.1k stars · 最新版 2.0.51 · 正在寻找新维护者 官方文档：https://publish.obsidian.md/kanban/ 核心格式：Frontmatter 声明 + 二级标题列 + 列表项卡片
---
kanban-plugin: basic
---
## 待办
- [ ] 任务一
- [ ] [[关联笔记]]
## 进行中
- [ ] 另一个任务 @{2026-04-01} #工作
## 已完成
- [x] 完成的任务 ✅
| 你要做什么 | 该怎么做 |
|---|---|
| 创建新看板 | Ctrl+P → Kanban: Create new board，或右键文件列表 → 新建看板 |
| 添加列/卡片 |
| 看板界面点击「+ 添加列」或列底部「+ 添加卡片」 |
| 编辑卡片内容 | 点击卡片展开编辑，支持完整 Markdown 语法 |
| 关联笔记 | 卡片内输入 [[ 弹出建议；或从文件面板拖入文件 |
| 设置截止日期 | 卡片内输入 @ 呼出日期选择器 |
| 设置精确时间 | 卡片内输入 @@ 呼出时间选择器 |
| 标记完成 | 勾选复选框，或输入完成触发字符 ✅（可自定义） |
| 从卡片新建笔记 | 右键卡片 → New note from card（自动双向链接，支持模板） |
| 归档已完成卡片 | 列菜单 → 归档已完成卡片；或命令面板 Kanban: Archive completed cards |
| 搜索卡片 | 看板右上角 🔍 按钮 |
| 切换视图 | 看板/表格/列表 三种视图，命令面板或看板头部按钮 |
| 跨看板拖拽 | 直接拖拽卡片到另一个看板窗口 |
| 配置看板选项 | 加载 references/board-settings.md |
| 结合 Tasks 插件 | 加载 references/tasks-integration.md |
| 获取配置模板 | 加载 references/config-templates.md |
在创建、编辑或删除任何看板内容之前：
.md 文件，了解现有内容和结构--- 包裹）和看板数据区域## 标题）和卡片格式（- [ ] 或 - [x]）%% kanban:settings %%）和归档注释块（%% kanban:archive %%）不变避免：
%% kanban:settings %% / %% kanban:archive %% 注释块遵循：
kanban-plugin 声明不变Kanban 内勾选复选框不会触发 Tasks 插件的重复任务逻辑。如需重复任务自动生成，须在 Tasks 查询视图或 Markdown 编辑器中完成勾选。详情见 references/tasks-integration.md。
Kanban 看板必须以独立 .md 文件存在，不能通过 ![[board.md]] 嵌入到其他笔记中显示。这是当前的已知限制。
---\nkanban-plugin: basic\n---## 列名 二级标题（列之间用空行分隔）- [ ] 卡片内容@{YYYY-MM-DD} 格式日期@@{HH:mm} 格式时间#标签名[[笔记名]]references/board-settings.mdreferences/archive-and-lane.mdreferences/tasks-integration.mdreferences/config-templates.mdreferences/faq.md| 语法 | 说明 | 示例 |
|---|---|---|
| 复选框 | 勾选标记完成 | - [ ] / - [x] |
| 双向链接 | 关联笔记，Ctrl+点击 预览 | [[笔记名]] |
| 标签 | 卡片分类，可设置颜色和点击操作 | #工作 #紧急 |
| 日期 | 截止日期，超期变红，可链接每日笔记 | @{2026-04-01} |
| 时间 | 精确时间 | @@{14:30} |
| 格式化 | 加粗、高亮、代码等 | **重要**、==关键==、`code` |
| 图片 | 嵌入图片 | ![[图片.png]] |
| 多行内容 | 卡片内换行继续书写（回车或 Shift+Enter） | 多行文本 |
| 外部链接 | 标准 Markdown 链接 | [文字](https://...) |
Tasks 元数据（需安装 Tasks 插件）：卡片中可使用 📅 🛫 ⏳ ⏫ 🔺 🔽 🔁 等 Emoji，会被 Tasks 插件全局识别。
支持看板视图（核心）、表格视图和列表视图三种切换，命令面板或看板头部按钮切换。
只加载当前任务所需的文件。不要一次全部加载。
| 文件 | 内容 | 加载时机 |
|---|---|---|
references/board-settings.md | Board Settings 全部配置项、标签/日期/归档/元数据显示 | 配置看板行为或外观时 |
references/tasks-integration.md | Tasks 语法、重复任务限制与替代方案 | 结合 Tasks 插件管理任务时 |
references/archive-and-lane.md | 归档系统、列独立设置 | 处理归档或列配置时 |
references/config-templates.md | 每日看板/项目跟踪/知识管理 预设模板 | 快速搭建某类看板时 |
references/faq.md | Frontmatter 限制、已知限制、故障排查 | 排查问题或遇到异常时 |
| ❌ 错误写法 | ✅ 正确写法 | 原因 |
|---|---|---|
删除 %% kanban:settings %% 注释块 | 保留该注释块不动 | 它存储了看板的全部配置 |
删除 %% kanban:archive %% 注释块 | 保留该注释块不动 | 它存储了已归档卡片数据 |
| 在 Frontmatter 中写列和卡片 | 列和卡片写在 --- 之后 | Frontmatter 只用于 kanban-plugin 声明 |
| 列之间没有空行分隔 | 列标题之间保留一个空行 | 空行确保 Markdown 解析正确 |
日期写成 @2026-04-01 | 日期写成 @{2026-04-01} | 大括号是标准格式 |
把 Tasks 的 📅 和看板的 @{} 混为一谈 | 两者可共存，但含义不同 | @{} 是看板日期，📅 是 Tasks 元数据 |
| 在看板里打勾期望 Tasks 自动重复 | 在 Tasks 查询视图里打勾 | 看板勾选不触发 Tasks 重复逻辑 |
尝试用 ![[board.md]] 嵌入看板 | 看板必须作为独立文件打开 | 看板不支持嵌入显示 |
在 kanban-plugin 值上随意修改 | 保持 kanban-plugin: basic | 其他值无官方支持 |