用途:创建和编辑 Obsidian Canvas(.canvas)文件。Canvas 是 Obsidian 原生功能,提供无限自由的可视化工作区,与 Mermaid(结构化图 DSL)和 Excalidraw(手绘草图)不同,它把笔记变成可拖拽卡片并保留完整内容与链接行为。
主要能力:可放置笔记卡片(vault 中 .md 文件的实时视图)、文本卡片(自由富文本)、文件卡片(图片、PDF 等内联显示)、网页卡片(嵌入 iframe)和分组框(带颜色的边界框)。Canvas 文件为 JSON,扩展名 .canvas,无需插件即可渲染。
使用方式:先确认 vault 路径并核对引用的笔记文件名,避免命名冲突;再规划布局(中心辐射、列布局、线性流程、嵌套集群等)与节点坐标;然后生成完整 JSON,节点类型包括 text、file、link、group,边用 fromNode/toNode、fromSide/toSide、label、color 连接;最后保存为 <名称>.canvas 并在 Obsidian 中打开,可拖拽卡片、点击编辑文本卡片,或从文件浏览器拖入 .md 文件。
限制:需 Obsidian 1.1.0 及以上;文件节点须用 vault 相对路径;节点与边 ID 必须唯一,边引用的节点必须存在;分组框靠位置和尺寸视觉界定成员,不显式列出子节点;不适用于手绘白板(用 excalidraw-diagram)或结构化流程图(用 mermaid-diagram)。