robertoallende/fancy-kanban
GitHub: robertoallende/fancy-kanban
一款可内联嵌入 Obsidian 笔记的 Markdown 看板插件,支持自定义字段、泳道分组与工作流管理,解决任务管理与笔记内容割裂的问题。
Stars: 8 | Forks: 0
# 高级 Kanban
终于有一款可以直接嵌入在笔记中的看板了。

## 为什么开发这个插件
我试过很多看板插件,但总是用不习惯。它们都独立存在于自己的标签页中,与我真正关心的笔记完全割裂——而且说实话,那些 UI 看起来还停留在 1999 年。我觉得我能做出更好的东西。这就是我开发 Fancy Kanban 的初衷。现在它来了——优劣由你来评判。
## 功能
- **直接嵌入笔记中的看板** —— 无需单独的视图,看板可以直接与你笔记中的其他内容内联渲染
- **卡片关联数据** —— 可以为每个看板自定义字段(文本、长文本、日期、数字、下拉选择、文件),而不仅仅是一个标题和一堆标签
- **拖放操作** —— 支持在同列内或跨列拖动来重新排列卡片,并带有工作流验证
- **卡片编辑器** —— 专用的弹窗界面,用于查看和编辑卡片上的每个字段
- **独立看板视图** —— 除了内联嵌入外,还可以通过侧边栏图标或命令面板将看板在其独立的面板中打开
- **看板设置面板** —— 通过专用的 UI 创建和编辑字段、列以及工作流,无需手动修改配置块
- **人类可读的格式** —— 看板数据存储为包含配置段和标准 Markdown 表格的代码块,因此即使没有安装该插件,数据依然(以表格形式)具有很高的可读性
- **泳道** —— 在看板配置中添加 `lanes:
` 即可实现第二个分组维度;卡片会按照“列 × 泳道”的网格进行排列,将卡片拖动到其他泳道行时可以同时更新两个字段
- **从 Obsidian Kanban 导入** —— 只需一条命令即可将现有的 `obsidian-kanban` 看板迁移过来;原有的泳道会转换为列,卡片及其关联笔记会被完整保留,内联的元数据(如日期、标签等)则会被自动清理掉
## 安装说明
**在 Obsidian 内部:**
1. 进入 Settings → Community plugins → Browse
2. 搜索 **Fancy Kanban**
3. 点击 Install,然后点击 Enable
## 使用方法
### 创建看板
- 在命令面板中运行 **Fancy Kanban: New board**,或者
- 点击 Fancy Kanban 的侧边栏图标
这会在你的笔记中插入一个 `fancy-kanban` 代码块(或者在独立视图中打开一个),并预置一套初始配置和空表格。接下来,你可以打开 **board setup** 面板来添加或编辑字段、列和工作流——除非你愿意,否则无需手动去修改配置块。

### 编辑看板
- 直接在渲染好的看板上添加、拖动或重新排列卡片
- 点击卡片即可打开卡片编辑器,在这里可以对卡片上的每一个字段进行编辑
- 你在操作时,底层的表格会自动更新——笔记的 Markdown 源码会始终与看板保持同步

### 从 Obsidian Kanban 导入
如果你有使用 [Obsidian Kanban 插件](https://github.com/mgmeyers/obsidian-kanban) 创建的看板,你可以通过简单的几个步骤将其迁移到 Fancy Kanban 中:
1. 打开 Obsidian Kanban 看板的 `.md` 文件
2. 在命令面板中运行 **Fancy Kanban: Import from Obsidian Kanban**
3. 系统会在同一文件夹下创建一个名为 `-fk.md` 的新文件,并自动打开它
原文件不会被修改。每条泳道会被转换为一个状态列,卡片标题会被保留(日期、标签、块 ID 和 wiki 链接会被清除),任何多行的卡片正文都会被转换为该卡片的 `description` 字段。
### 泳道
在看板配置中添加 `lanes: `,即可按照第二个 Select 字段对卡片进行分组。看板将以网格形式渲染——顶部显示列标题,左侧显示泳道标签。将卡片拖动到不同的泳道行时,会在同一次操作中同时更新列和泳道字段。

```fancy-kanban
lanes: genre
```
任何 `Select` 字段都可以作为泳道字段。你也可以直接在看板设置面板中进行配置——完全无需手动修改代码。
### 数据格式
每个看板实际上就是一个代码块——以下是上面那个看板在笔记源码中的真实面貌:

```fancy-kanban
---
title: Website Relaunch
fields:
- name: title, type: Text, label: Title
- name: status, type: Select, options: todo|doing|done, label: Status, default: todo
- name: due, type: Date, label: Due
- name: priority, type: Select, options: low|medium|high, label: Priority
workflow: todo→doing, doing→done, doing→todo, done→doing
---
| _id | Status | Title | Due | Priority |
|--------|--------|------------------------|------------|----------|
| a1b2c3 | todo | Rewrite homepage copy | 2026-07-28 | high |
| d4e5f6 | todo | Source new photography | | medium |
| g7h8i9 | todo | Draft pricing page | 2026-08-02 | |
| j1k2l3 | doing | Build nav component | 2026-07-20 | high |
| m4n5o6 | doing | Migrate blog posts | | low |
| p7q8r9 | done | Set up staging env | 2026-07-10 | |
| s1t2u3 | done | Pick color palette | 2026-07-05 | medium |
```
因为其底层本质上是一个标准的 Markdown 表格,所以即使没有安装本插件,在任何 Markdown 阅读器中,该看板依然可以(以不带交互的表格形式)正常阅读。
## 功能请求与问题反馈
如果你有希望优先开发的功能需求,欢迎[提交 issue](https://github.com/robertoallende/fancy-kanban/issues)——我们的路线图规划会充分考虑实际的使用场景和用户反馈。
## 开源协议
[MIT](https://github.com/robertoallende/fancy-kanban/blob/main/LICENSE) — Copyright (c) 2026 Astuten.io Ltd
[](https://github.com/robertoallende/fancy-kanban/actions/workflows/ci.yml)
[](https://codecov.io/github/robertoallende/fancy-kanban)
[](https://claude.ai/chat/LICENSE)标签:Linux 内核安全, Markdown, Obsidian插件, 任务管理, 效率工具, 看板, 笔记工具, 自动化攻击, 防御加固, 项目管理