思源插件功能:文档树导图、块导图、文档卡、镜像块与子文档
在思源里,KMind Zen 导图不是外挂附件,而是文档树的一部分:可以像文档一样创建、嵌进正文、从文档转换而来,也能把思源的块和文档拖进画布变成会同步的卡片。这一页的十五段动图都在思源里录制。
要点
- 文档树和 Dock 两个入口都会弹出建图窗口,可以命名并选主题。
- 块导图插在正文里,悬停右上角图标或右键菜单都能进入编辑。
- 拖进画布的块卡和文档卡与原内容双向同步。
- 长文档可以按标题一键拆成层级子文档;MOC 模式下直接用导图整理文档树,改动写回思源。
- 思源块链接、PDF 标注可以直接粘进导图变成可点击的链接节点;节点正文里输入 / 或 [[ 就能插入思源文档链接。
文档树导图
在文档树里右键一篇文档,选「文档下方插入 KMind」,弹出的建图窗口里输入名称、挑一张主题卡,点「创建」。
新导图会作为一篇文档出现在文档树里并直接打开,之后像管理文档一样管理它。
Dock 栏导图
点左侧 Dock 里的 KMind 图标打开面板,点面板头部的「新建」,同样弹出建图窗口。
Dock 导图不占文档树位置,适合临时灵感和草稿,面板里能随时切换。
块导图插入正文
在正文空段落输入 /,选「插入 KMind Zen 块导图」,正文里会出现一张导图预览图,同时自动打开它的编辑器。
回到文档时预览图已经就位;每次在编辑器里保存,预览图都会刷新。
编辑正文里的块导图
把鼠标移到块导图预览图上,右上角会出现 KMind 图标,点它直接打开编辑器。
也可以右键预览图,在「插件」子菜单里选「编辑导图」。
文档一键转导图与胶囊操作
打开一篇普通文档,点面包屑右侧的「文档转导图」,正文原地渲染成导图,右上角出现一个胶囊。
展开胶囊可以在「标题大纲」和「完整块树」之间切换结构,也能创建可编辑副本;点「返回编辑」回到正文。转换不会修改文档。
标题一键拆分为子文档
在标题大纲模式下展开胶囊,点「拆分为子文档」。确认框会列出将要转换的标题,确认后每个标题按层级原位变成一篇思源子文档,三级标题会嵌在对应的二级标题文档下面。
拆分完成后文档自动进入 MOC 模式,正文位置直接显示为文档树导图;展开文档树就能看到新长出来的层级子文档。原文档保留标题前的正文和 document ID。
MOC 模式:用导图整理文档树
在文档树里右键一篇有子文档的文档,选「开启 / 关闭 MOC 模式」,这篇文档就以导图形式显示它的子文档树:根节点是文档本身,子节点一一对应子文档。
在 MOC 导图里选中节点按 Tab,思源文档树里会立刻新建一篇子文档(默认叫「未命名文档」);双击节点输入新标题回车,就是给这篇文档重命名。拖动调整顺序或层级同样会写回思源,思源文档树始终是真相源。
拖拽思源块生成块卡并双向同步
把导图和文档分屏,抓住正文块左侧的拖拽手柄拖到画布上,松手后生成一张块卡。
在块卡里输入的文字会同步回文档,在文档里的修改也会同步到块卡。
拖拽文档生成文档卡并双向同步
从文档树把一篇文档拖到画布空白处,生成一张带标题、时间和摘要的文档卡。
卡片工具条里点「右侧打开」可以并排编辑原文档,「切换为 Live」后卡片本身也可以直接编辑,两边实时同步。
粘贴思源块链接
在思源正文里把光标放进某个块,按 ⇧⌘H(或点块手柄选「复制 → 复制块超链接」),得到一个 siyuan://blocks/… 链接;Markdown 形式的块链接也能识别。
点一下导图空白处再 ⌘V,会新建一个正文可读的链接节点:节点文字直接取思源块的内容,点节点上的思源图标就能跳回原块。选中一个已有正文的节点再粘贴,则只给它追加这条外链,不改正文。
PDF 标注粘贴为可点击的 PDF 链接
在思源的 PDF 阅读器里划选一段文字、点一个高亮色,思源会创建标注并把标注引用复制到剪贴板。
回到导图里 ⌘V,KMind Zen 会把它识别成 PDF 标注:新节点以标注文字为标题,带 PDF 图标;点击这个链接会重新打开 PDF 并定位到那处标注。
镜像块
在导图画布空白处右键,选「复制 KMind 镜像块」,再到目标文档里 ⌘ V 粘贴。
文档里会渲染出这张导图的镜像,它始终跟随原导图更新。
- 快捷键:⌘ V 粘贴镜像块
节点子文档
右键一个节点,选「创建节点子文档」,文档树里会在导图文档下面生成一篇以节点文字命名的子文档并打开。
节点上会出现一个外链挂件,点它就能跳到子文档,适合把某个分支展开写成长文。
节点正文输入 / 快捷插入思源文档
编辑节点正文时输入 /,快捷菜单里除了公式等通用项,还有一组「思源文档」:继续输入几个字就能按标题过滤当前笔记本里的文档。
选中一篇文档,节点里会插入指向它的链接(siyuan://blocks/…),显示为文档标题;点击链接即可打开这篇思源文档。
节点正文输入 [[ 快捷插入思源文档
习惯双向链接写法的话,在节点正文里输入 [[ 也会直接弹出思源文档搜索,输入标题片段即可过滤。
选中后同样插入一条指向该文档的链接,效果与 / 菜单里的「思源文档」一致,只是入口更顺手。
相关资源
常见问题
块导图会占用思源的资源目录吗?
会。块导图的预览图与数据包存放在 assets 目录,导图数据存放在插件的数据目录,删除块时可以一并清理。
文档转导图会改动原文档吗?
不会。它只在当前视图里把文档渲染成导图,刷新后回到正文;需要长期编辑请在胶囊里创建可编辑副本。














