JSON Canvas如何把散落笔记连成一张知识图谱：4个最小步骤上手

JSON Canvas如何把散落笔记连成一张知识图谱：4个最小步骤上手

【免费下载链接】jsoncanvasAn open file format for infinite canvas data.项目地址: https://gitcode.com/GitHub_Trending/js/jsoncanvas

你的读书笔记藏在微信收藏夹，思维导图躺在软件里，参考文献散在桌面文件夹——想找两条线索之间的关系时，它们互不相认。JSON Canvas 是一种开放的空间画布文件格式（.canvas扩展名），专门干这件事：让信息块自由摆放、再用连线建立关系，把散点拼成网。

一、这个项目到底解决什么问题：一张"便签墙"

把无限画布理解成一面便签墙就够了。墙上的每张便签是一个节点，便签和便签之间贴的箭头是边——你看到的就是一个节点、一条边。

• 节点：墙上一张有坐标和尺寸的卡片。可以是纯文字（支持 Markdown）、指向某个本地文件的引用、一个链接，或者一个把别的便签圈起来的分组框。
• 边：连接两张卡片的线。它记录"从谁到谁"、两端接在卡片的哪条边上（上/下/左/右），箭头可开可关，还能挂一行小字标签。

这面墙是开放格式：文件就是 JSON 文本，任何工具都能读写，换软件不丢数据。格式细节以 spec/1.0.md 为准。

二、画出第一张图的4个最小步骤

📌 用读书笔记做例子。整个过程四步，每步有明确的产出。

1. 准备一个.canvas文件。新建空文件，内容就是两段数组：

{ "nodes": [ {"id": "a", "type": "text", "x": 0, "y": 0, "width": 200, "height": 80, "text": "核心论点"} ], "edges": [] }

2. 摆节点。每张便签必须给全五个字段：id、type、位置（x/y）、尺寸（width/height），文本节点再加text。想给便签染色就加color（预设色 "1"~"6"，如 "5" 是青色）。

3. 画边。边只需三个必填项：

{"id": "e1", "fromNode": "a", "toNode": "b", "label": "支撑"}

fromNode、toNode填节点 id，label可选。

4. 用工具打开验证。在支持 JSON Canvas 的应用里打开文件，节点按数组顺序叠放（排后面的在上层），边自动对齐卡片边缘。产出：一张能拖动、缩放、导出的空间笔记。

三、从"画图"到"图谱"：补三类字段

想让它成为能查的图谱，不用换格式，只需给便签和箭头补充语义。

升级前的边只说"a 和 b 有关"；升级后的边能说"a 引用 b，强度 0.8，出处是第 3 章"。空间布局不变，语义维度就加上了。

四、工具怎么选

按你的处境挑，不用全试：

• 如果你已经在用 Obsidian，它原生支持 JSON Canvas 的存储、导入和导出，直接无缝接上，成本最低。
• 如果你想要一个网页画板，hi-canvas、Kinopio、Charkoal 都支持导入导出，挑顺手的用即可。
• 如果你想嵌入自己的应用，选对应语言的开发库——Python 有 PyJSONCanvas，前端有 React、Vue、TypeScript 库，拿来做解析和渲染层。

完整清单见 docs/apps.md（应用、格式转换工具、各语言库都在里面）。

五、常见误区与坑

1. 把画布当图谱用。只连线、不写label和关系类型，图看着热闹，查不出任何结论。边上的文字才是图谱的灵魂。
2. 坐标随手堆，不做布局规划。便签越贴越挤，回看时找不着北。建议先按"分组"分区域再摆，分组节点（type": "group"）就是干这个的。
3. 以为节点只有文字。file、link、group三种类型同样好使，引用原文文件比抄全文省事得多。

收尾

JSON Canvas 解决的核心问题只有一个：让空间上摆得开、关系上连得起来。当你手里的知识块超过一屏、且彼此存在引用和因果时，就值得给它建一面便签墙——从第二节的四步开始，一张图半小时内就能画完。

【免费下载链接】jsoncanvasAn open file format for infinite canvas data.项目地址: https://gitcode.com/GitHub_Trending/js/jsoncanvas