Obsidian笔记变成可拖拽看板只需3步：kanban插件新手避坑指南

Obsidian笔记变成可拖拽看板只需3步：kanban插件新手避坑指南

【免费下载链接】obsidian-kanbanCreate markdown-backed Kanban boards in Obsidian.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-kanban

我的一个朋友小周，Obsidian 里存了 800 多篇笔记，却总在微信上向我诉苦："我知道记了很多东西，但打开仓库就像走进一间没有灯的黑板房，什么都抓不住。"她的待办列表写了一页又一页，进度却永远停留在"写了一半"。

如果你也有同样的感觉——笔记越记越多，任务却越来越失控——那你需要的不是再记一条笔记，而是换一种"看"笔记的方式。Obsidian kanban 插件（项目名 obsidian-kanban）就是为此而生的免费开源插件：它能把普通的 Markdown 文件变成一个可以拖拽卡片的看板，让你的知识管理和任务跟踪在同一个窗口里完成。

接下来的内容，我会用小周的真实经历带你走一遍完整流程，顺便把新手最容易踩的坑都标出来。

从一间"黑板房"开始：安装与第一次创建看板

小周的第一步，是在 Obsidian 的社区插件市场里搜索 "Kanban"，找到作者 mgmeyers 的那款，点击安装并启用。整个过程一分钟都用不上。

Obsidian插件商店中搜索并安装kanban插件的界面

安装完成后，她没有急着点任何按钮，而是新建了一个 Markdown 文件，然后在文件最顶部写下这样三行字：

--- kanban-plugin: basic ---

保存文件的瞬间，编辑器视图就变成了一块空白看板。原理很简单：这个插件把你的看板数据全部存成 Markdown 文本，你随时可以切回源码模式查看和手动修改，就算插件哪天出了问题，笔记内容也一分不丢。

这里有个新手常踩的坑：把kanban-plugin: basic写进了别的地方，比如正文中间，或者写错了拼写。记得它必须独占文件最顶部的 YAML 区块。如果你只是想快速试试，也可以按Ctrl + P打开命令面板，搜索 "Kanban: Create new board"，直接生成一个标准看板文件。

把待办"写"进看得见的格子里

第一次打开看板，小周盯着那个孤零零的默认列发了一会儿呆，问我："然后呢？"

然后就是重复三次的操作：

1. 点击列顶部的+添加新列，分别命名为"想做"、"在做"、"做完"；
2. 在每个列里点击+ Add a card，把散落在各篇笔记里的任务关键词搬进来；
3. 用鼠标拖住卡片，从一个列拖到另一个列，任务状态就更新了。

Obsidian看板插件的基础看板视图，包含卡片和添加卡片按钮

她突然发现，以前要翻好几篇笔记才能拼出来的"项目全貌"，现在一眼就看完了。卡片支持完整的 Markdown 语法，标题、列表、引用、代码块都可以塞进去，和你在普通笔记里写字没有任何区别——卡片本质上就是一小段 Markdown。

给看板装上红绿灯：WIP 限制到底怎么设

用了一周，小周又来找我，这次语气里带着点得意："我现在有 14 张卡在'在做'列里。"我反手就给她上了一课：看板不是越满越好，没有限制的"在做"列，等于没有看板。

Obsidian 看板插件的 WIP 限制（work in progress limit，进行中工作限制）设置方法极其隐蔽但极其简单：编辑列标题，在名字后面加一个括号数字。比如把列名从"在做"改成：

在做 (3)

保存后，列标题旁边会出现一个计数器。当卡片数量超过限制时，数字会变成粗体提醒你"超载了"。

Obsidian看板插件设置WIP限制后列标题显示计数的界面

小周把"在做"列限制成 3 张卡之后，她不得不逼着自己先完成一件事，才能把新任务拖进来。一周后她跟我说，这是她这些年效率提升最大的一次调整。想改限制？直接重命名列，数字跟着变，没有第二个入口需要找。

一张卡片能装下多少东西：日期、图片和元数据

过了两周，小周开始给卡片"加料"。她最常用的是给卡片添加日期：在卡片里输入@会弹出一个日期选择器，点一下就选中了；或者右键卡片，在弹出的菜单里选择Add a date，效果一样。

Obsidian看板插件为卡片添加日期时弹出的日历选择器

然后是图片。在卡片里嵌入图片和在笔记里一样，直接写 Obsidian 的双链语法就行：

![[项目示意图.png]]

Obsidian看板插件卡片中直接嵌入图片的效果，同时展示YAML元数据写法

但如果你想从关联笔记的元数据里自动拉一张图片显示在卡片上，就得先去设置里开启 "Linked page metadata"，添加一个元数据键，并打开Field contains markdown开关。这里藏着一个超容易被忽视的坑：

• 如果图片存在 YAML 前端元数据里，必须用引号包起来：delivery-notes: "![[LinkToImage.png]]"，否则 YAML 会解析出错；
• 如果你装了 Dataview 插件，用行内元数据则不需要引号：delivery-notes:: ![[LinkToImage.png]]。

小周第一次没加引号，看板直接不显示图片，她排查了半小时才在文档里翻到这个细节。记住这句话：前端元数据加引号，行内元数据不用，能帮你省掉大量时间。

别让看板变成第二个杂物间：归档与反哺笔记

看板用了一个月，小周"做完"列里堆了 40 多张卡。她问我能不能删掉，我拦住她：删了就什么都没有了，应该用归档。

右键卡片，选择Archive card，卡片就会从看板上消失，但内容完整保留在 Markdown 文件底部的归档区。想查看归档？按Ctrl + P搜索 "Kanban: Toggle between Kanban and markdown mode"，切到源码模式就能看到。这是一个很好的"有进有出"机制：看板保持清爽，历史又不丢失。

Obsidian看板插件卡片右键菜单，包含编辑、归档、删除、添加日期等选项

还有一个小周特别喜欢的操作：从卡片反哺笔记。右键卡片选择New note from card，插件会自动以卡片标题创建一篇新笔记，并把卡片链接过去。她现在的习惯是：任务在看板上流转，等任务有了成果，就从卡片长出笔记，把思考沉淀回知识库。看板和笔记库就这样连成了一个闭环。

写到这里，小周的看板已经运行了三个月。她后来在日记里写了一段话，我看了很久："以前我觉得记录和做事是两件事，一个在笔记里，一个在脑子里。现在它们住在同一个格子里。"

Obsidian kanban 插件最好的地方，不是它有多少炫酷功能，而是它从不绑架你的数据——所有内容都是普通 Markdown，你随时可以离开，也可以随时回来。你的看板不是一张要填满的表格，而是你思考方式的外壳。先搞清楚你自己想怎么工作，再让看板去适应它，而不是反过来。

从写下那三行kanban-plugin: basic开始吧，剩下的，交给你的第一张卡片。

【免费下载链接】obsidian-kanbanCreate markdown-backed Kanban boards in Obsidian.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-kanban