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（应用、格式转换工具、各语言库都在里面）。
五、常见误区与坑
- 把画布当图谱用。只连线、不写
label和关系类型，图看着热闹，查不出任何结论。边上的文字才是图谱的灵魂。 - 坐标随手堆，不做布局规划。便签越贴越挤，回看时找不着北。建议先按"分组"分区域再摆，分组节点（
type": "group"）就是干这个的。 - 以为节点只有文字。
file、link、group三种类型同样好使，引用原文文件比抄全文省事得多。
收尾
JSON Canvas 解决的核心问题只有一个：让空间上摆得开、关系上连得起来。当你手里的知识块超过一屏、且彼此存在引用和因果时，就值得给它建一面便签墙——从第二节的四步开始，一张图半小时内就能画完。
【免费下载链接】jsoncanvasAn open file format for infinite canvas data.项目地址: https://gitcode.com/GitHub_Trending/js/jsoncanvas
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
