工具-09-Excalidraw绘图
这篇笔记讲什么
Excalidraw 是一个手绘风格的白板工具,Obsidian 的 Excalidraw 插件把它变成了「能画、能链、能嵌入、能自动化」的视觉笔记系统。
本篇从安装与界面的最小可用集讲起,然后讲清插件最容易被忽略的三件事:
.excalidraw.md文件格式、绘图与笔记的双向链接、嵌入与导出;最后给出模板、素材库、脚本自动化、AI、演示与避坑清单。一条建议:先只学 20% 的功能(画图、嵌入、链接、导出),剩下的等真的需要时再翻对应小节。
本文对应的实际环境
本文按 Obsidian 1.14.4 + Excalidraw 插件 2.29.0(2026-10-12 发布)编写,并以本仓库
wyl123ly的真实配置与绘图文件为例。菜单名按简体中文界面书写;如果你切到英文界面,在命令面板搜
Excalidraw即可找到对应命令。版本升级后个别选项可能改名,以插件设置页和 官方 README 为准。
一、是什么
1.1 三个层次
理解 Excalidraw 要先分清三个层次,很多困惑来自把它们混在一起:
| 层次 | 是什么 | 在哪里 |
|---|---|---|
| Excalidraw 本体 | 一个开源的、手绘风格的白板/画图应用 | excalidraw.com |
| Obsidian 插件 | 把 Excalidraw 的画布塞进 Obsidian,并把图形存成 Markdown 文件 | .obsidian/plugins/obsidian-excalidraw-plugin/ |
| 你的绘图文件 | 一个同时是 Markdown 又能在画布中编辑的 .excalidraw.md 文件 | 仓库的 Excalidraw/ 目录 |
所以它不是「在笔记里插一张图片」,而是一种新的笔记类型:既有画布,又有 Markdown 文本、标签、双链和 frontmatter。
1.2 关键概念
| 概念 | 含义 | 对应中文界面 |
|---|---|---|
| Drawing | 一张绘图,本质是 .excalidraw.md 文件 | 绘图 |
| Element | 画布上的一个对象(矩形、箭头、文本、图片……) | 元素 |
| Container / Bound text | 图形内部的绑定文字,随图形移动缩放 | 容器 / 绑定文本 |
| Element link | 挂在某个元素上的链接,点击可跳到笔记或网址 | 元素链接 |
| Frame | 画框,用来切分幻灯片、打印页、导出区域 | 画框 |
| Embeddable | 嵌在画布里的可交互对象(网页、YouTube、Markdown 页面、PDF) | 嵌入内容 / MD-Embeddable |
| Template | 新绘图的默认样式模板 | 模板 |
| Library | 可复用的图形素材集合(.excalidrawlib) | 素材库 |
| Script | 用 ExcalidrawAutomate(ea)写的小程序 | 脚本 / Excalidraw 自动化 |
1.3 和 Mermaid、Canvas、draw.io 的区别
| 工具 | 本质 | 适合 | 不适合 |
|---|---|---|---|
| Excalidraw | 手绘风格的自由画布 + 笔记双链 | 概念图、算法图解、白板推演、视觉索引 | 精确到像素的工程图、大规模协作 |
| Mermaid | 用文本描述图,自动布局 | 流程图、时序图、状态图、结构稳定的图 | 自由排版、手绘感、复杂空间关系 |
| Obsidian Canvas | 无限画布上摆卡片/笔记 | 把已有笔记空间化、拼贴、项目管理 | 自由绘制、手绘线条 |
| draw.io / Visio | 规范图形库 + 精确排版 | UML、架构图、正式交付物 | 快速记录想法、视觉笔记 |
选择口诀
结构清楚、要跟着代码改 → Mermaid;要摆放、要手感、要链回笔记 → Excalidraw;只是把笔记摆开 → Canvas。
二、为什么值得用
2.1 它解决的问题
- 文字是线性的,结构不是。 一个算法的状态转移、一本书的概念关系,用图表达比用段落快得多。
- 手绘风格降低「画不好」的心理门槛。 歪歪扭扭的线反而让注意力回到内容上。
- 它长在 Obsidian 里。 图能链回笔记,笔记能嵌图,图里的文字能被全文搜索,链接会进反向链接和图谱。
- 一张图可以同时服务多个场景。 画一次,可以当笔记插图、当复习卡片、当演示页、当导出图片。
2.2 不适合的场景
- 需要严格规范符号的 UML、电路图、正式架构图:用 draw.io、Mermaid 或专业工具。
- 多人实时协作:excalidraw.com 的协作功能不在 Obsidian 插件里。
- 超大画布(几千个元素):加载、保存、同步都会变慢,应拆成多张图。
- 需要发布到网页且要求「可编辑」:Obsidian Publish 不渲染
.excalidraw,只能导出 SVG/PNG。
2.3 代价
| 代价 | 具体表现 | 缓解 |
|---|---|---|
| 多一种文件格式 | 多出 .excalidraw.md 文件,搜索时可能看到压缩数据 | 保持「压缩 JSON」开启 |
| 学习曲线 | 工具栏和设置项极多 | 先只用选择、矩形、箭头、文本、导出 |
| 同步风险 | 文件较大,同步冲突会产生损坏的 JSON | 开启自动保存,避免多端同时编辑 |
| 迁移成本 | 图里的信息不在纯文本里 | 关键结论同时写进笔记正文 |
三、安装与初始化
3.1 安装
本仓库已经安装并启用了该插件,下面是复现步骤:
- 打开 设置 → 第三方插件(社区插件),关闭「受限模式(Restricted mode)」(旧版叫「安全模式」)。
- 点「浏览」,搜索 Excalidraw,作者是 Zsolt Viczian(插件 ID:
obsidian-excalidraw-plugin)。 - 安装后启用。左侧功能区出现一支铅笔图标,文件资源管理器里也能右键新建绘图。
- 建议同时把插件固定在侧边栏:右键功能区图标 →「固定」。
插件很大,且更新频繁
main.js约 5 MB,更新走 Obsidian 社区插件市场,大约每月一个版本。若用 Obsidian Sync 同步插件目录,可能出现「只同步了 manifest、没同步 main.js」的版本不匹配警告,此时重新下载插件即可。
3.2 首次设置检查清单(本库现状)
设置路径:设置 → Excalidraw。2.29 用的是 Obsidian 的可搜索多页设置界面。下表是本仓库 data.json 里的真实值,可作为起点:
| 设置项 | 本库当前值 | 说明 |
|---|---|---|
| Excalidraw 文件夹 | Excalidraw | 新绘图默认存放位置 |
| 文件扩展名 | .excalidraw.md(开启) | 关闭会变成普通 .md,部分功能受限 |
| Excalidraw 模板文件 | Excalidraw/Template.excalidraw | 该文件目前不存在,所以新绘图是空白样式 |
| 脚本文件夹 | Excalidraw/Scripts | ExcalidrawAutomate 脚本目录 |
| 素材库存储位置 | 仓库文件(Excalidraw/Libraries/local-library.excalidrawlib) | 比存在 data.json 更稳 |
| 压缩 Excalidraw JSON | 开启 | 文件更小,搜索更干净 |
| 自动保存 | 桌面 60 秒 / 移动 30 秒 | 焦点离开文件时也会触发保存 |
| 嵌入源文件类型 | 绘图文件本身(excalidraw) | 也可改为引用自动导出的 PNG/SVG |
| 预览图格式 | SVG | 清晰且可缩放 |
| 默认打开模式 | 普通模式 | 另有查看模式、禅模式 |
| 桌面端 UI 模式 | 托盘模式(Tray) | 工具栏收成托盘,画布更大 |
| 离线 CJK 字体 | 未开启 | 中文手写字体默认联网加载 |
| AI 功能 | 已开启,但未配置 API Key | 目前等于不可用 |
三个最值得改的设置
1. 模板文件:调好一张图的样式后设为模板,新绘图就不用每次重设颜色和字体。
2. 默认打开模式:如果你主要拿它当「看板/演示」,改成「查看模式」。
3. 将链接作为注释插入(在「嵌入到 Markdown 文档中的绘图」一节):开启后,嵌入 SVG/PNG 时会在下方补一条
%%绘图%%注释,保住图谱和反向链接。
3.3 2.29 的重要变化:Excalidraw Extras
从 2.29 起,一部分「重」功能被拆到配套插件 Excalidraw Extras,以控制主插件体积(Obsidian Sync 对单文件有大小限制)。涉及:
- MathJax(LaTeX 公式渲染)
- Mermaid 转 Excalidraw
- PDF 导出
- 本地文件系统访问(把仓库外的图片嵌进画布)
如果插入公式、导出 PDF 或转换 Mermaid 时弹出「需要 Excalidraw Extras」,去社区插件里安装并启用它即可。本仓库目前没有安装 Extras,所以这些功能在写这篇笔记时用不了;基础的画图、嵌入、链接、PNG/SVG 导出都不受影响。
这不等于功能被砍掉
主插件仍然是完整的绘图工具,只是把高权限、大体积的扩展库交给第二个插件按需加载。安装 Extras 后,原菜单位置基本不变。
3.4 中文与字体
- 插件本身有简体中文翻译,命令名、设置项都是中文(本文按中文界面写)。
- Excalidraw 内置的「手写」字体不含中文。插件的做法是从互联网加载 CJK 手写字体;首次使用中文手写字体时可能需要等一会儿。
- 想完全离线:下载官方字体包,解压到
Excalidraw/CJK Fonts,再在设置里开启「离线 CJK 字体支持」和「启动时从文件加载中文字体」。 - 等宽/代码风格选 Cascadia;普通中文用「正常」字体族即可,它会回退到系统中文字体。
四、第一张图:界面与基本操作
4.1 新建与命名
三种新建方式,效果相同:
- 点左侧功能区的铅笔图标。
- 命令面板(
Ctrl+P)执行Excalidraw: 新建绘图文件。 - 在文件资源管理器里右键文件夹 →「新建 Excalidraw 绘图」。
文件名格式由设置决定,本库是 Drawing YYYY-MM-DD HH.mm.ss.excalidraw.md,例如:
Excalidraw/Drawing 2026-10-18 18.02.31.excalidraw.md
建完立刻改名
默认文件名只有时间,一周后你分不清哪张是哪张。建完马上按
F2重命名,例如算法图解-二叉堆.excalidraw.md。在 Obsidian 里改名,不要用文件管理器改,否则嵌入链接不会自动更新。
4.2 界面
一张绘图窗口由五块组成:
| 区域 | 内容 | 常用动作 |
|---|---|---|
| 左上角菜单 | 汉堡菜单(☰) | 打开/导出/切换视图/帮助/脚本库 |
| 左侧工具栏 | 选择、矩形、菱形、椭圆、箭头、线、手绘、文本、图片、橡皮、画框、便签、更多工具 | 选工具,或在工具上右键看快捷键 |
| 左上角属性面板 | 描边、背景、填充、线宽、线型、粗糙度、透明度、图层 | 改选中元素的样式 |
| 右上角 | 更多选项(⋯)、画布背景、缩放 | 导出、切换主题、设置画布 |
| 底部 | 缩放条、撤销/重做 | 缩放、撤销 |
桌面端有三种 UI 模式:Desktop-mode(完整)/ Compact-mode(紧凑)/ Tray-mode(托盘),本库是托盘模式——工具栏收成一个小托盘,画布更大。用命令 Excalidraw: 切换 UI 模式 循环切换。
4.3 画基本图形
| 工具 | 快捷键 | 备注 |
|---|---|---|
| 选择 | V | 单击选中,拖拽框选;Shift 加选 |
| 矩形 | R | 按住 Shift 画正方形 |
| 菱形 | D | 流程图判断框常用 |
| 椭圆 | O | 按住 Shift 画正圆 |
| 箭头 | A | 端点靠近图形会自动绑定 |
| 直线 | L | 折线:点击多个点,Enter 结束 |
| 手绘 | P | 数位板/触控笔可用压感 |
| 文本 | T | 双击画布也能直接输入 |
| 橡皮 | E | 对象橡皮,不是像素橡皮 |
| 画框 | F | 用来做幻灯片/导出区域 |
| 便签 | N | 2.28 新增,适合头脑风暴 |
| 手形/平移 | H 或按住空格拖拽 | 查看大图时用 |
三个立刻提升手感的小动作
- 画完一个图形后不要点回选择工具,直接按下一个工具的快捷键,连续画。
- 想复制:
Ctrl+D,或按住Alt拖拽。- 想调整大小但保持比例:拖角点时按住
Shift。
4.4 文本与公式
- 独立文本:
T→ 点击画布 → 输入;Esc或点击空白结束。 - 容器内文字:先画图形,双击图形内部,输入的文字会绑定到图形(移动、缩放图形时文字跟随)。
- 字体:手写(Virgil)、正常(Helvetica)、代码(Cascadia);设置里还能启用第四种本地字体。
- 字号、对齐、行高:选中文本后在左侧属性面板调整。
- 文本里可以写链接:
笔记名、显示文字、别名,按住Ctrl点击即可打开。 - 公式:文本里写 LaTeX,例如
$O(n\log n)$或独立成行的$$T(n)=2T(n/2)+O(n)$$;也可用命令Excalidraw: 插入 LaTeX 公式到当前绘图中。渲染依赖 MathJax(2.29 起由 Excalidraw Extras 提供)。
文本元素是「可检索」的
图里的文字会被写进
.excalidraw.md的文本区,因此 Obsidian 的全文搜索能搜到,也能被块引用。把关键结论写成文本元素,而不是手写涂鸦,否则它只是一堆线条。
4.5 箭头绑定与容器
- 箭头从图形边缘拖出,端点出现高亮即表示绑定;之后移动图形,箭头会跟随。
- 绑定错了:选中箭头,拖动端点离开图形即可解绑。
- 文字绑进容器后,想单独选中文字:双击进入编辑,或用命令 「只选择文本元素(非容器)」。
- 想禁止自动绑定:命令
Excalidraw: 开启或关闭绑定。
4.6 对齐、编组、图层
- 选中多个元素后,左侧属性面板出现对齐按钮(左/中/右、上/中/下)和分布按钮。
- 编组:
Ctrl+G;解组:Ctrl+Shift+G。组可以嵌套。 - 图层顺序:右键 →「置于顶层/上移一层/下移一层/置于底层」。
- 锁定:右键 →「锁定」,防止误拖;解锁在同一菜单。
- 吸附:拖动时靠近其他元素会出现对齐参考线,帮助你快速摆齐。
4.7 保存与视图切换
- 自动保存:默认 60 秒(桌面),切走标签页时也会保存。
- 手动保存:
Ctrl+S,或命令Excalidraw: 保存(同时更新嵌入了该绘图的 Markdown 文档)。手动保存会顺带刷新嵌入它的笔记预览,改完图回笔记看不到变化时用它。 - 切换视图:右上角 ⋯ 菜单 →「打开为 Markdown」;或命令
Excalidraw: 在 Excalidraw 和 Markdown 模式之间切换。 - Markdown 视图里看到的是文件的「文本面」,可以写说明、加 frontmatter;Excalidraw 视图是「画面」。
五、文件格式:.excalidraw.md 里到底存了什么
5.1 一个真实文件
本仓库现有的那张空绘图,原始内容如下(压缩数据已截断):
---
excalidraw-plugin: parsed
tags: [excalidraw]
---
==⚠ Switch to EXCALIDRAW VIEW in the MORE OPTIONS menu of this document. ⚠== You can decompress Drawing data with the command palette: 'Decompress current Excalidraw file'. For more info check in plugin settings under 'Saving'
## Drawing
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MQHNsYfpwBGAOlT0AtmIBeNCtlQbs6RmPry6uA4wC0KDDgLFLUTJ2lH8MTDHQ0YNMWHRJMRZFFgBORQAGMiRPVRhGMBoEAG0AXXJ0KCgAZQCwPlBJfDwc7A0+Rk5MTHIdGCIAIXRUAGtirkZcAGF6THp8BBAAYgAzcYmQAF8poA===
%%
要点:
- frontmatter 里的
excalidraw-plugin: parsed是「这是绘图」的开关,删了它就变成普通笔记。 tags: [excalidraw]让绘图能被标签检索;可以加自己的标签。- 那句
==⚠ Switch to EXCALIDRAW VIEW...==只是提示文字,Excalidraw 视图会忽略它。 - 真正的画布数据在
## Drawing下面的代码块里。 - 末尾的
%%是 Markdown 注释标记,插件用它把数据区挡在阅读视图之外。
5.2 各区块
当绘图里有更多内容时,## Drawing 之前会出现额外小节:
| 区块 | 何时出现 | 作用 |
|---|---|---|
# Excalidraw Data | 完整结构时的容器标题 | 把下面的数据小节收在一起 |
## Text Elements | 图里有文本元素 | 文本的明文副本,供全文搜索与块引用 |
## Element Links | 元素上挂了链接 | 元素 ID 与链接的映射 |
## Embedded Files | 图里嵌了图片 | 图片文件与元素 ID 的对应 |
## Drawing | 总是存在 | Excalidraw 场景 JSON(压缩或明文) |
# Markdown Images | 用了「可编辑 Markdown 图像」 | 图像里保存的 Markdown 正文 |
空绘图为什么只有
## Drawing文本、链接、嵌入文件这三个小节是按需生成的。图是空的,自然只剩画布数据。所以「文件看起来比别人短」不代表坏了。
5.3 JSON 压缩与解压
开启「压缩 Excalidraw JSON」后,场景数据会被 LZ-String 压缩并 Base64 编码,放进标记为 compressed-json 的代码块,目的是:
- 文件体积更小;
- 避免大段明文 JSON 污染 Obsidian 的全文搜索;
- 减少同步冲突时的合并体积。
需要看/改 JSON 时:
- 命令
Excalidraw: 解压当前 Excalidraw 文件(一次性解压,切回画布保存后会重新压缩); - 或开启设置 「在 Markdown 视图中解压缩 Excalidraw JSON」,让每次切到 Markdown 视图都自动解压(官方建议保持关闭,用命令按需解压)。
本库当前:压缩开、Markdown 视图自动解压关。
5.4 可以改什么、不能改什么
不要用格式化工具处理绘图文件
Prettier、EditorConfig、保存时自动格式化等工具会在
## Text Elements后加空行、调整缩进,而插件对该区块极其敏感。轻则第一个文本元素错位,重则整张图无法加载。如果已经在用,去设置里开启「兼容代码格式化(Linting)」,让插件插入一个「虚拟文本元素」替你挨刀——但最好的办法仍是把
.excalidraw.md排除在格式化之外。
可以安全修改的:
- frontmatter 里的自定义属性(标签、
excalidraw-*配置); - frontmatter 之后、数据区之前的说明文字(插件会忽略但保留);
- Markdown 视图里的正文(配合
excalidraw-open-md等属性,见 6.4)。
不要碰的:
excalidraw-plugin: parsed这一行;## Drawing下的数据块本身(除非你明确知道自己在改什么);%%注释标记的位置;## Text Elements里的空行和^元素ID后缀。
5.5 常用 frontmatter
在绘图文件的 frontmatter 里可以按文件覆盖插件设置,常用的有:
| 键 | 取值 | 作用 |
|---|---|---|
excalidraw-plugin | parsed | 必需,标记这是绘图 |
tags | 任意 | 标签,如 [excalidraw, 算法] |
excalidraw-default-mode | normal / zen / view | 打开这张图时的模式 |
excalidraw-open-md | true / false | 默认用 Markdown 视图打开 |
excalidraw-embed-md | true / false | 被嵌入时显示 Markdown 面而不是图 |
excalidraw-autoexport | none / both / svg / png | 单张图的自动导出策略 |
excalidraw-export-transparent | true / false | 导出透明背景 |
excalidraw-export-dark | true / false | 导出深色/浅色版本 |
excalidraw-export-padding | 数字 | 导出边距(像素) |
excalidraw-export-pngscale | 0.5–5 | PNG 导出倍率 |
excalidraw-export-embed-scene | true / false | 导出图片时嵌入场景数据 |
excalidraw-link-prefix | 字符串,如 "📍 " | 内部链接在画布上的前缀 |
excalidraw-url-prefix | 字符串,如 "🌐 " | 外部链接前缀 |
excalidraw-link-brackets | true / false | 画布上是否显示 [[ ]] |
excalidraw-font | Virgil / Cascadia / 字体文件 | 嵌入 Markdown 时的字体 |
excalidraw-embeddable-theme | dark / light / auto / default | 嵌入内容(如 PDF)的主题 |
让属性自动补全
设置里开启 「将 Excalidraw 属性加载到 Obsidian 的自动提示中」(需重启插件),之后在 frontmatter 里输入
excalidraw-就有补全和说明。
六、把图嵌进笔记
6.1 三种方式
方式一:用命令(推荐给新手)
- 打开要插图的那篇笔记;
- 命令面板执行
Excalidraw: 嵌入绘图 (图:drawing) 到当前 Markdown 文档中; - 选择已有绘图,或输入新文件名(命令会自动创建)。
- 也可以一步到位:
Excalidraw: 新建绘图 - 于新标签页 - 并嵌入到当前 Markdown 文档中。
方式二:手写嵌入
![[算法图解-二叉堆.excalidraw]]
注意扩展名是 .excalidraw,不是 .excalidraw.md——Obsidian 会自动匹配到 .excalidraw.md 文件。
方式三:拖拽
从文件资源管理器把绘图文件拖进笔记的编辑区,Obsidian 默认插入链接;是否变成嵌入取决于 Obsidian 的拖放设置,不如前两种可控。
6.2 尺寸与对齐
嵌入语法支持在链接里指定尺寸和样式(这是插件扩展的语法,不是 Obsidian 原生):
![[绘图.excalidraw]] ← 使用默认宽度(本库 400)
![[绘图.excalidraw|400]] ← 宽度 400
![[绘图.excalidraw|400x300]] ← 宽 400、高 300
![[绘图.excalidraw|400|left]] ← 宽度 400,左对齐
![[绘图.excalidraw|right-wrap]] ← 右浮动,正文绕排
<alignment> 部分会被写进 SVG/包装元素的 style,所以除了 left、right、center,理论上可以填任意 CSS 片段(例如 float:right;margin:0 0 1em 1em)。常用值就够用了。
实时预览里能不能用
本库开启了「嵌入绘图到文档时,模拟嵌入图片的语法」,因此实时预览(Live Preview)里也能用
(图:绘图)。如果语法不生效,重新打开这篇笔记。
6.3 链接注释与反向链接
- 如果你选择「嵌入源文件类型 = SVG/PNG」,笔记里放的是图片文件,图谱和反向链接就断了。
- 解决:开启设置 「将链接作为注释插入」。插件会在图片下方补一行:
```markdown
%%算法图解-二叉堆.excalidraw%%
```
Obsidian 把它当注释不显示,但链接关系仍然成立:图谱有边,绘图的反向链接里也能看到这篇笔记。
- 直接嵌入
.excalidraw文件时不需要注释,因为链接本身就在。
6.4 预览与打开
| 操作 | 效果 |
|---|---|
| 鼠标悬停 | 显示绘图预览(受「鼠标悬停预览时渲染为图像」等设置影响) |
| 单击 | 打开绘图(在查看模式下需双击,取决于「在查看模式下允许双击打开链接」) |
| 长按(移动端) | 打开嵌入的绘图,延迟可在设置里调 |
Ctrl+点击 链接文字 | 打开元素链接指向的笔记 |
| 嵌入显示成链接而不是图 | 检查插件是否启用、预览缓存是否生成;本库的预览图格式是 SVG |
强制把嵌入显示为图片:在链接后加 #^as-image,例如:
![[绘图.excalidraw#^as-image]]
让绘图默认用 Markdown 面打开:在该绘图 frontmatter 加 excalidraw-open-md: true;让它被嵌入时显示 Markdown 面:加 excalidraw-embed-md: true。
6.5 在 Canvas 中使用
- 把
.excalidraw.md文件拖进 Canvas,会生成一个绘图卡片,双击即可打开绘图; - 本库开启了 「Obsidian 白板支持 → 沉浸式嵌入」,绘图在 Canvas 中会以更完整的方式呈现;
- Canvas 的连线是「卡片之间的关系」,Excalidraw 里的箭头是「元素之间的关系」,两者不要混用:结构关系画在图里,笔记关系放 Canvas。
七、双向链接:让图和笔记互相指向
这是 Excalidraw 插件最被低估的能力。图不是终点,它是链接的枢纽。
7.1 文本里的链接
在文本元素里直接写:
参考 [[算法-动态规划与贪心]] 的状态定义
对比 [[数据结构-图]] 里的邻接表
外部资料:[Excalidraw 文档](https://docs.excalidraw.com/)
- 按住
Ctrl点击文字即可打开;文本右上角会出现一个链接指示器。 - 开启「鼠标悬停预览内部链接」后,悬停链接可预览目标笔记。
- 绘图里的链接会出现在目标笔记的反向链接中;移动/重命名笔记时,Obsidian 会自动更新链接(前提是开启了「自动更新内部链接」)。
7.2 元素链接
给图形本身挂链接,适合做「可点击的索引图」:
- 选中一个元素(矩形、图片、文本都行);
- 按
Ctrl+K,或右键 →「添加链接」,或命令Excalidraw: 以链接形式插入文件; - 输入
笔记名、笔记或网址; - 之后按住
Ctrl点击该元素即可跳转。
元素链接 vs 文本链接
文本链接是「字里带链接」,适合正文;元素链接是「整个图形可点」,适合卡片式索引。同一张图可以两种混用。
7.3 引用图的局部
这是从笔记「反查」图里某个局部的关键。选中元素后,用命令复制链接:
Excalidraw: 复制所选元素的 file 链接—— 普通元素链接;- 同命令按住
Ctrl—— 复制所在分组:!file; - 同命令按住
Shift—— 复制所在区域(裁切图):!file; - 画框:
复制所选画框为 !file 链接; - 裁切画框:
复制所选画框(裁切)为 !file 链接。
用法示例:
| 写法 | 效果 |
|---|---|
[[绘图.excalidraw#^abc123]] | 文本元素 → 链接到该段文字;非文本元素需配合 group/area |
![[绘图.excalidraw#^group=abc123]] | 只显示该元素所在分组 |
![[绘图.excalidraw#^area=abc123]] | 只显示该元素周围的裁切区域 |
![[绘图.excalidraw#^frame=slide1]] | 只显示某个画框(幻灯片) |
![[绘图.excalidraw#^area=abc123,padding=120]] | 裁切区域外扩 120 像素 |
还可以按章节标题引用:在文本元素里写 # 状态转移(以 # 开头的文本会被当作章节),然后:
![[绘图.excalidraw#area=状态转移]]
语法以命令复制的为准
#^id、#^group=、#area=这些前缀由插件解析,不同版本的写法略有差异。别手打,选中元素后用命令复制,粘到笔记里最稳。
7.4 反向链接与二级链接
- 打开一篇笔记 → 右侧「反向链接」面板,会列出所有指向它的绘图(因为绘图里的
链接也算链接)。 - 开启「显示二级链接」后,点击链接时会同时展示目标的反向链接;对于「图标 + 多个原子笔记」的索引图,这能少点一次。
- 图谱视图里,绘图是节点,绘图里的链接是边。图本身也是一条知识。
7.5 一个知识地图的例子
flowchart LR
A[Markdown 笔记] -- "嵌入绘图" --> B[.excalidraw.md 绘图]
B -- "链接回笔记" --> A
B -- "文本元素 ID" --> C[笔记中的块引用]
C -- "跳转/局部嵌入" --> B
具体做法:
- 建一张
知识地图-线性代数.excalidraw.md; - 画若干圆角矩形代表章节,文字写
3-1-向量空间这样的链接; - 给每个矩形挂元素链接,指向对应笔记;
- 用分组把相关章节框在一起,之后在笔记里用
#^group=引用; - 把这张图嵌入
00-索引或课程主页; - 以后每新增一篇笔记,就在图上加一个节点——图会自然变成你的「目录」。
八、把内容嵌进画布
8.1 图片
| 操作 | 结果 |
|---|---|
粘贴截图(Ctrl+V) | 图片按 Obsidian 附件规则保存到仓库,并插入画布 |
| 从系统拖入图片 | 默认导入到仓库(本库 Windows 设置) |
| 从网页拖入图片 | 默认按 URL 引用,不保存到仓库 |
| 直接粘贴图片 URL | 以 URL 形式插入,联网才能显示 |
命令 从 URL 下载图片到本地 | 把 URL 图片下载进仓库,变成可离线 |
- 2.29 改进了附件处理:粘贴和拖入的图片会遵循 Obsidian 的附件路径设置,也能兼容附件管理插件。
- 仓库外的本地图片需要「本地文件系统访问」能力(2.29 起由 Excalidraw Extras 提供)。
- 右键图片有「裁剪图片并添加蒙版」「在 Excalidraw 中标注图片」,会分别生成
cropped_、annotated_前缀的新绘图。
8.2 Markdown
三种粒度,按需选择:
① 文本嵌入——把笔记的一段文字放进画布(不是截图,是活文本):
在文本元素里写:
![[某篇笔记#^dp-state]]
![[某篇笔记#^block]]{40}
{40} 表示每 40 个字符折行;整页嵌入 (图:笔记) 时,显示字符数上限由设置「MD-Transclusion 的最大显示字符数」控制(本库 200)。
② 图像嵌入(MD-Embeddable)——把整篇笔记渲染成一张可交互的卡片:
- 从文件资源管理器按住
Shift拖入画布; - 或命令
Excalidraw: 以图像形式嵌入 Markdown 文档到当前绘图中; - 卡片内可以直接滚动、勾选待办;单击进入编辑(取决于「单击编辑嵌入的 Markdown」);
- 右键卡片 →「Embeddable 元素设置」可改宽度、背景色、边框、是否显示属性、锁定阅读模式。
③ 可编辑 Markdown 图像(2.2x 新增)——文字直接存在图里,适合在画布上排版说明块:
- 命令
Excalidraw: 插入可编辑的 Markdown 图像; - 双击图像即可编辑 Markdown,支持标题、列表、链接、代码;
- 可复制其 SVG 交给 LLM 生成 CSS(设置里也有 CSS 编辑器)。
什么时候用哪种
要「读」一段笔记 → 文本嵌入;要「用」一篇笔记(勾待办、看表格)→ MD-Embeddable;要「在图里写说明」→ 可编辑 Markdown 图像。
8.3 PDF
- 命令
Excalidraw: 以图像形式嵌入 PDF 到当前绘图中,选择 PDF; - 支持页码范围(如
1,3-5,7)、缩放、加边框容器、放入画框、编组; - 导入后是图片元素,不是可编辑 PDF;想跳页可以在链接里用
#page=2; - 裁剪区域参数是
#rect=左,下,右,上,例如#rect=0,0,500,500; - 嵌入主题可用
excalidraw-embeddable-theme覆盖。
PDF 导出 ≠ PDF 导入
把 PDF 页面放进画布是主插件自带功能;把绘图导出成 PDF 在 2.29 由 Excalidraw Extras 提供,别搞混。
8.4 网页与视频
- 从浏览器拖入链接,默认变成链接(YouTube 链接会带缩略图);按住
Ctrl+Shift拖入则变成可交互网页嵌入; - 拖入 YouTube 链接会生成缩略图 + 元素链接,且支持嵌入播放;
- 网页嵌入本质是 iframe,很多站点会拒绝被嵌入,显示空白是正常现象;
- 设置里的「使用 oEmbed 获取页面标题」会让拖入的链接自动带标题(需要联网)。
8.5 LaTeX 与 Mermaid
- LaTeX:文本里写
$...$或$$...$$,或用命令插入公式;可Ctrl+点击公式编辑。2.29 起渲染由 Excalidraw Extras 提供。 - Mermaid 转 Excalidraw:把 Mermaid 代码变成可编辑的图形元素(同样在 Extras 中)。适合「先用 Mermaid 想清楚结构,再转成手绘图微调」。
- Mermaid 的优点是改代码就改图;转成 Excalidraw 后就失去了这种「代码即图」的能力,转之前想清楚是否真的需要手工调整。
8.6 SVG 导入
- 命令
Excalidraw: 导入 SVG 文件为线条(暂不支持文本元素); - 适合把图标、简单示意图变成可改的线条;
- 复杂 SVG(渐变、滤镜、文字)会丢失或变形,别指望完美还原。
8.7 拖拽修饰键总表
以下是本库 Windows 默认配置(设置 → 链接和嵌入 → 配置修饰键)。macOS 的 Ctrl 对应 Cmd,以设置页显示为准。
| 来源 | 默认拖入 | Ctrl | Shift | Ctrl+Shift |
|---|---|---|---|---|
| 本地文件(系统) | 导入到仓库 | 链接形式插入 | 图像形式嵌入 | 交互形式嵌入 |
| 浏览器 | 按 URL 引用图片/缩略图 | 链接形式插入 | 导入到仓库 | 交互形式嵌入 |
从 Obsidian 内部(文件资源管理器、其他笔记)拖到画布时,键位不一样:
| 内部拖动 | 结果 |
|---|---|
| 默认 | 链接形式插入 |
Shift | 图像形式嵌入 |
Ctrl+Shift | 交互形式嵌入(MD-Embeddable) |
Ctrl+Alt | 图像形式嵌入(100% 尺寸) |
修饰键冲突会「看起来没反应」
插件不会检查你的组合是否和 Obsidian 快捷键冲突。改过之后如果某个动作失效,先恢复默认,再逐个加。
九、模板、素材库、画笔
9.1 模板
模板决定新绘图的默认样式:描边颜色、填充、字体、字号、线宽、粗糙度、画布背景,甚至调色板。
创建模板:
- 新建一张空白绘图,调好你想要的样式(比如蓝灰配色、Cascadia 字体、细线);
- 在设置 「Excalidraw 模板文件」 里把路径指向这张绘图(可直接输入,或用路径建议列表选择;本库当前是
Excalidraw/Template.excalidraw,但文件不存在); - 之后新建绘图会自动套用这些样式。
模板也可以是文件夹
把该设置指向一个文件夹,新建绘图时会让你选择用哪个模板。适合「算法图模板」「读书卡片模板」「演示模板」多套并存。
模板负责的是样式与画布设置的继承,不会替每张新图设置打开模式。想让某张图默认以查看模式打开,直接在该图的 frontmatter 里写:
excalidraw-default-mode: view
9.2 素材库
- 打开方式:工具栏的素材库按钮,或命令
Excalidraw: 打开 Excalidraw 侧边面板; - 本库的本地素材库文件:
Excalidraw/Libraries/local-library.excalidrawlib(仓库文件存储,比塞进data.json稳); - 把外部
.excalidrawlib文件放进该文件夹会自动加载;也可以用面板里的导入按钮; - 从 excalidraw.com 的 Libraries 下载的素材包可以直接用;
- 命令 **
Excalidraw: 导出 stencil 库为 *.excalidrawlib 文件** 可备份/分享你的素材库。
同步素材库
如果用 Obsidian Sync,需要在同步设置里勾选「同步所有其他文件类型」,否则
.excalidrawlib不会同步到其他设备。
9.3 自定义画笔
- 设置 → 自定义画笔:可定义钢笔、荧光笔、马克笔等,指定颜色、粗细、压感、起笔/收笔形状;
- 定义后可固定到侧边栏,画草图时一键切换;
- 支持数位板压感;没有压感设备也能用(固定压力);
- 「触控笔模式」可在打开绘图时自动开启,适合平板。
十、自动化:Excalidraw Automate 与脚本
10.1 脚本引擎
插件暴露了一个叫 ExcalidrawAutomate(简称 ea)的 API,脚本就是一段 JavaScript,运行在 Obsidian 里,能读写当前画布。
- 脚本放在设置里的脚本文件夹(本库
Excalidraw/Scripts); - 支持
.md、.js(需开启「允许 JavaScript 文件」);本库是.md; - 装好的脚本会出现在命令面板,可以像普通命令一样分配快捷键;
- 官方有脚本库(工具栏「脚本库」按钮,或命令
Excalidraw: 安装或更新 Excalidraw 脚本),可以直接浏览、安装、更新社区脚本。
10.2 第一个脚本
在 Excalidraw/Scripts/ 下新建一个 .md 文件,写入:
// 给选中的元素画一个蓝色外框
const elements = ea.getViewSelectedElements();
if (elements.length === 0) {
new Notice("请先选中至少一个元素");
return;
}
// 计算所有选中元素的包围盒
const box = ea.getBoundingBox(elements);
// ea.style 是「下笔样式」,对之后创建的图元生效
ea.style.strokeColor = "#1971c2";
ea.style.strokeWidth = 2;
ea.style.roughness = 0; // 0 = 不手抖,规整线条
ea.addRect(
box.topX - 10,
box.topY - 10,
box.width + 20,
box.height + 20
);
// false = 不把元素复制到光标处,按原坐标添加
ea.addElementsToView(false);
保存后,在命令面板搜索脚本名即可运行;也可以给它绑定快捷键。
常用 API(记住这几个就能写大部分脚本):
| API | 作用 |
|---|---|
ea.getViewSelectedElements() | 取当前选中的元素 |
ea.getViewElements() | 取画布上所有元素 |
ea.getBoundingBox(elements) | 计算包围盒(topX、topY、width、height) |
ea.addRect / addEllipse / addDiamond / addText / addArrow | 创建图元,返回元素 ID |
ea.addToGroup([ids]) | 编组 |
ea.copyViewElementsToEAforEditing(els) | 把已有元素复制进 EA 以便修改 |
ea.addElementsToView(repositionToCursor, save) | 把 EA 里新建/修改的元素写回画布(repositionToCursor 默认 false) |
ea.style.* | 设置下一次创建元素的样式 |
ea.getScriptSettings() / ea.setScriptSettings() | 读写脚本自己的设置 |
ea.getExcalidrawAPI() | 拿到底层 Excalidraw API(读写 appState) |
utils.inputPrompt(...) / utils.suggester(...) | 弹输入框 / 选择器 |
10.3 脚本设置
脚本可以把自己的设置注册到插件设置页:
let settings = ea.getScriptSettings();
if (!settings["边框颜色"]) {
settings = {
"边框颜色": {
value: "#1971c2",
description: "外框描边颜色"
},
"提示输入内边距": true
};
ea.setScriptSettings(settings);
}
第一次运行后,设置页里会出现「已安装脚本的设置 → 你的脚本名」。用户改完,脚本下次运行时读到的就是新值。
10.4 自动执行与安全
| 机制 | 何时运行 | 风险 |
|---|---|---|
| 手动运行 | 命令面板/快捷键 | 最低 |
| 自动启动脚本(autostart) | 每次打开绘图 | 中,脚本有写文件能力 |
| 加载期脚本(onload) | 打开带 excalidraw-onload-script 的文件 | 高,可执行任意命令 |
| 启动期脚本(startup) | 插件启动时 | 高 |
命令链接(cmd://) | 点击画布上的链接 | 高,可触发任意 Obsidian 命令 |
只运行你信任的脚本
官方在设置里默认关闭「加载期脚本」和「命令链接」,并会在首次遇到时弹窗确认。不要因为「看起来方便」就全局打开;从网上下载的绘图文件可能夹带恶意脚本。
10.5 与其他插件配合
- Templater / QuickAdd:可以在模板里调用 ExcalidrawAutomate 创建绘图、插入元素;
- Dataview:可以查询绘图 frontmatter 里的自定义属性,把「图」纳入表格;
- Latex Suite:装上后编辑公式会有实时预览(插件会在你插入公式时提示安装)。
10.6 Excalidraw CLI(2.29 新增)
2.29 增加了原生 CLI,供本地 AI 智能体或自动化脚本调用:
- 需要 Obsidian 1.12.2+ 且开启 CLI(本库版本满足);
- 命令
Excalidraw: 显示 CLI 和智能体说明会给出用法; - 基本形式:
obsidian vault="My vault" obsidian-excalidraw-plugin:help; - 脚本里也能用
ea.executeCLI(),ea.create()支持指定精确路径创建绘图。
这条对普通用户暂时用不上,知道「以后可以让 AI 直接改图」即可。
十一、导出与发布
11.1 导出对话框
命令 Excalidraw: 导出为图片(或右上角 ⋯ →「导出绘图…」)打开对话框,分三个标签页:
图片:
| 选项 | 说明 |
|---|---|
| 导出范围 | 整个场景 / 仅选中部分 |
| 边距 | 图片四周留白,避免贴边被裁 |
| 缩放 | 影响输出像素尺寸(PNG) |
| 主题 | 浅色 / 深色 |
| 背景 | 透明 / 使用场景颜色 |
| 包含场景数据 | 是/否。选「是」时,PNG/SVG 里带着场景,拖回 Obsidian 可继续编辑 |
| 导出内部链接为 SVG/PDF | 保留链接可点击 |
输出方式:导出 PNG、导出 SVG、PNG/SVG 保存到仓库、PNG/SVG 复制到剪贴板,以及导出 .excalidraw 源文件。
PDF:页面大小、方向、分页(适配到最多 N 页)、纸张颜色、页边距、对齐方式。2.29 起需 Excalidraw Extras,且仅桌面端。
截图:把可交互嵌入(网页、YouTube、Markdown 卡片)也拍进去,仅桌面端、仅 PNG、不能自动导出。
11.2 自动导出
设置 → 导出 → 导出设置:
| 选项 | 作用 |
|---|---|
| 自动导出 SVG 副本 | 每次保存都生成同名 .svg |
| 自动导出 PNG 副本 | 每次保存都生成同名 .png |
| 同时导出深色和浅色主题 | 生成 name.dark.png / name.light.png |
| 保持 SVG/PNG 文件名与绘图文件同步 | 重命名/删除绘图时同步文件 |
| 在导出图片中嵌入场景 | 同「包含场景数据」 |
单张图可用 frontmatter 覆盖:excalidraw-autoexport: none/both/svg/png。
什么时候值得开自动导出
你要把图嵌进其他不支持 Excalidraw 的地方(网页、Word、GitHub、Publish)时,开 SVG 自动导出最省事。平时关闭,减少文件数量和同步负担。
11.3 发布(Obsidian Publish)
- Publish 不渲染
.excalidraw文件,发布后只会显示一个链接/空白。 - 解决办法:开启自动导出 SVG/PNG,然后在笔记里嵌入导出后的图片。
- 发布前用命令
Obsidian Publish:搜索过期的 SVG 和 PNG 导出文件检查有没有忘记更新的副本。 - 深色/浅色双版本可以配合网站的
prefers-color-scheme使用。
11.4 演示
- 用画框(
F) 把内容切成若干页,每个画框是一页幻灯片; - 在该绘图 frontmatter 写
excalidraw-default-mode: view,打开即进入查看模式; - 查看模式下没有编辑工具栏,适合投屏;用命令「切换全屏模式」可进一步隐藏界面;
- 导出 PDF 时另选页面适配方式;画框主要用来组织内容、逐页查看。
十二、AI 功能(实验性)
12.1 配置
设置 → AI(实验性):
- 开启「启用 AI 功能」(重启 Obsidian 后生效);
- 在「定义可用的提供商」里配置 provider:OpenAI、Anthropic/Claude、Google/Gemini、xAI/Grok、OpenAI 兼容/本地;
- 填 API Key 和 base URL;本地模型可填一个占位 Key;
- 选择默认的文本与多模态模型、图像模型;
- 「AI 用量」面板可查看本次会话的 token 消耗。
本库的 AI 开关是开的,但所有 provider 都没有 Key,所以当前不可用。
12.2 能做什么
按插件设置里的说明,AI 能力主要用于:
- Mermaid chat:用自然语言生成/修改 Mermaid 图;
- diagram-to-code:把画布上的图转成代码/描述;
- 线框图分析:让多模态模型读草图并给建议;
- 图像生成与编辑:文生图、基于提示词的图像变换、蒙版编辑(取决于所选模型的能力);
- 社区脚本 ExcaliAI、GPT-Draw-a-UI 等也基于同一套配置。
12.3 建议
成本、隐私与稳定性
- AI 功能是实验性的,接口和行为可能随版本变化;
- 调用会产生费用,长图/多模态请求尤其贵;
- 图片和提示词会发送给你配置的第三方服务;
- API Key 存在插件
data.json里,不要把该文件提交到公开仓库。
如果只是画图,完全不需要配 AI。它的价值主要在「把草图转成代码」「把文字描述转成初稿」这类一次性劳动上。
十三、实战工作流
13.1 算法图解 → 题解笔记
以 P1040 加分二叉树 这类树形 DP 题为例:
- 新建
算法图解-加分二叉树.excalidraw.md; - 画中序序列和若干子树区间,用矩形 + 绑定文字表示状态;
- 用箭头标出「枚举根节点 → 划分左右子树」的转移;
- 给每个关键步骤的图形挂元素链接,指向题解笔记的对应标题;
- 在题解笔记顶部嵌入整张图:
(图:算法图解-加分二叉树.excalidraw); - 在「转移方程」一节点用
!...只嵌该局部; - 复习时先看图,想不起来再点元素链接跳回题解。
用画框分步
一张图里放 4 个画框,分别是「定义状态」「转移」「边界」「答案」,复习时缩放至画框逐个看,比一张大图更清楚。
13.2 课程概念图
以 3-1-向量空间 为例:
- 中心放「向量空间」,四周放「子空间」「基」「维数」「线性映射」;
- 每个节点写
笔记名,并挂元素链接; - 用不同颜色区分「定义」「定理」「例子」;
- 把图嵌入课程索引笔记;
- 学期末用
#^group=把某一章的分组单独抽出来做复习卡片。
13.3 日记与会议白板
以 2026-10-10 这类日记为例:
- 当天新建一张白板,记录待办、想法、草图;
- 待办用便签(
N)或文本的- [ ]; - 会议白板里给「行动项」挂链接,指向项目笔记;
- 把白板嵌回日记:
(图:2026-10-10 白板.excalidraw); - 周末翻日记时,图比文字更容易唤起记忆。
13.4 读书视觉笔记
以 被讨厌的勇气 为例:
- 画「目的论 vs 原因论」的对比图;
- 每个概念旁写书中的原话(文本元素,便于搜索);
- 用箭头表示「课题分离 → 共同体感觉」的递进;
- 书评笔记里只放图 + 几段文字,图承担结构,文字承担论证;
- 用
#^area=把「课题分离」局部嵌进相关主题笔记。
十四、常见坑与排错
| 现象 | 可能原因 | 解决 |
|---|---|---|
打开绘图只看到一段 ==⚠ Switch to EXCALIDRAW VIEW...== | 当前在 Markdown 视图 | 右上角 ⋯ →「打开为 Excalidraw 绘图」,或命令切换 |
| Markdown 视图里图画不出来 | 「Markdown 模式的 Excalidraw 在阅读模式将渲染为图像」被关闭 | 开启该设置,重开文件 |
| 笔记里的嵌入显示成链接/空白 | 预览缓存未生成、插件未启用、链接写错扩展名 | 用 Ctrl+S 保存绘图;确认链接是 .excalidraw;重启 Obsidian |
| 改了图,笔记里的预览没变 | 嵌入的是旧预览缓存 | 命令「保存(同时更新嵌入了该绘图的 Markdown 文档)」 |
| 中文显示成方块 | CJK 字体未加载/无网络 | 联网等字体加载,或下载字体到 Excalidraw/CJK Fonts 并开启离线加载 |
| 绘图打不开,提示 JSON 错误 | 同步冲突、格式化工具改坏了 ## Text Elements、手动编辑出错 | 用插件备份恢复;或用「解压当前文件」检查;从同步历史找回 |
| 全文搜索搜不到图里的字 | 文字是手写涂鸦/图片,不是文本元素 | 关键结论用文本元素重写 |
复制到笔记的 #^id 链接点不开 | 复制后文件被重命名/移动,或手打了 ID | 用命令重新复制;确保 Obsidian 自动更新链接开启 |
![[...#^group=...]] 不显示 | 元素没编组,或 ID 过期 | 重新选元素 → 命令复制 group 链接 |
| 导出 PNG 太大/太小 | 缩放比例设置 | 导出对话框调「缩放」,或 frontmatter excalidraw-export-pngscale |
| Publish 上看不到图 | Publish 不支持 .excalidraw | 嵌入自动导出的 SVG/PNG |
| 插入公式/导出 PDF/转 Mermaid 提示缺插件 | 2.29 起这些功能在 Excalidraw Extras | 安装并启用 Excalidraw Extras |
| 脚本运行没反应 | 脚本不在脚本文件夹、语法错误、未安装依赖 | 看开发者控制台(Ctrl+Shift+I)的报错 |
| 多端编辑后文件损坏 | 同步冲突 | 不要多端同时编辑;用 Sync 的历史版本恢复 |
出问题先做三件事
1. 切到 Markdown 视图看 frontmatter 是否还在、
## Drawing是否完整;2. 命令面板跑一次「保存」;
3. 还不行就看开发者控制台,插件的报错通常写得很清楚。
十五、快捷键
15.1 画布快捷键
| 键 | 功能 |
|---|---|
V / R / D / O | 选择 / 矩形 / 菱形 / 椭圆 |
A / L / P | 箭头 / 直线 / 手绘 |
T / E / F / N | 文本 / 橡皮 / 画框 / 便签 |
H 或空格拖拽 | 平移画布 |
Ctrl+K | 给选中元素添加链接 |
Ctrl+G / Ctrl+Shift+G | 编组 / 解组 |
Ctrl+D | 复制选中元素 |
Ctrl+A | 全选 |
Ctrl+Z / Ctrl+Shift+Z | 撤销 / 重做 |
Ctrl+Enter | 编辑选中文本 |
Shift+1 | 缩放至适应画布 |
Shift+2 | 缩放至选中元素 |
Ctrl+0 | 100% 缩放 |
? | 打开快捷键帮助面板 |
W(2.29) | 包裹/解包:文字入图形、标签脱离、元素包进画框 |
Alt+点击(2.29) | 在重叠元素之间循环选择 |
快捷键以画布内
?面板为准Excalidraw 会随版本调整按键;某些键还会被 Obsidian 全局快捷键抢走。插件设置里有「热键覆盖」,可以把冲突的键优先给 Excalidraw(例如
Ctrl+K创建链接、Ctrl+Enter编辑文本)。
15.2 插件命令(命令面板可搜)
| 命令 | 用途 |
|---|---|
Excalidraw: 新建绘图文件 | 新建 |
Excalidraw: 在 Excalidraw 和 Markdown 模式之间切换 | 切换视图 |
Excalidraw: 嵌入绘图 ![[drawing]] 到当前 Markdown 文档中 | 插图 |
Excalidraw: 新建绘图 - 于新标签页 - 并嵌入到当前 Markdown 文档中 | 新建并插图 |
Excalidraw: 导出为图片 | 导出对话框 |
Excalidraw: 保存(同时更新嵌入了该绘图的 Markdown 文档) | 强制保存并刷新嵌入 |
Excalidraw: 解压当前 Excalidraw 文件 | 查看/编辑 JSON |
Excalidraw: 插入 LaTeX 公式到当前绘图中 | 公式 |
Excalidraw: 以图像形式嵌入 Markdown 文档到当前绘图中 | MD-Embeddable |
Excalidraw: 以图像形式嵌入 PDF 到当前绘图中 | PDF 页面 |
Excalidraw: 复制所选元素的 [[file#^id]] 链接 | 元素级引用 |
Excalidraw: 安装或更新 Excalidraw 脚本 | 脚本库 |
Excalidraw: 显示 CLI 和智能体说明 | 2.29 的 CLI |
Excalidraw: 切换 UI 模式 | 切换桌面/紧凑/托盘 |
十六、练习题
- 基础题:新建一张绘图,画三个矩形并用箭头连接,给中间那个矩形加一个指向
00-索引的元素链接,再把整张图嵌入到任意笔记里,宽度设为 500。 - 进阶题:给一张图里的两个相关元素编组,然后从笔记里用
#^group=只嵌入这个分组,并比较它和#^area=的效果差异。 - 进阶题:写一个脚本,把所有选中文本元素的字号统一改成 20,并把描边颜色改成当前主题色。
- 思考题:什么情况下应该用 Mermaid,什么情况下应该用 Excalidraw?举一个你实际遇到的场景,并说明如果换成另一种工具会损失什么。
- 综合题:给你正在学的一门课做一张「知识地图」,要求包含至少 6 个笔记链接、2 个分组、1 个画框,并嵌入到课程索引笔记中。
十七、FAQ
Q:Excalidraw 和 Obsidian Canvas 到底怎么选?
A:Canvas 是「把已有卡片摆开」,节点是笔记/图片/网页;Excalidraw 是「自己画」,节点是图形元素。要建立空间关系用 Canvas,要画结构和示意用 Excalidraw。两者可以互相嵌套:Canvas 里放 Excalidraw 卡片,Excalidraw 里嵌入笔记。
Q:绘图文件会不会让仓库变重?
A:会,但比想象中小。开启压缩后,一张中等复杂度的图通常几十到几百 KB;大量嵌入图片才是体积大头。建议图片统一放附件目录,定期清理未引用附件。
Q:能不能在手机/平板上用?
A:能。插件支持移动端,手机上是专门的 UI 模式;手写笔模式下可以压感书写,双击橡皮擦、单指平移等手势可在设置里调。嵌入的绘图在移动端需要长按打开。
Q:为什么我的图里有中文,但搜索搜不到?
A:只有文本元素会进入全文索引。手写涂鸦、图片里的文字不算;可以把关键文字用文本元素再写一遍,或用 OCR(Taskbone,需要 API Key 且会上传图片)识别后写入 frontmatter。
Q:(图:图) 和 (图:图) 有什么区别?
A:前者用默认宽度;后者指定宽度(像素)。还可以 |400x300 指定宽高、|400|left 指定对齐、|right-wrap 右浮动绕排。
Q:能不能把图导出成可编辑的 PPT/Word?
A:不能直接导出。可以导出 PNG/SVG 后插入;SVG 在 Word/PPT 里仍是矢量图,放大不糊,但字体和样式在不同软件里可能变化。
Q:2.29 之后为什么 LaTeX/PDF 导出用不了?
A:这些功能被拆到了配套插件 Excalidraw Extras。安装并启用它即可,主插件的画图、嵌入、链接、PNG/SVG 导出不受影响。
Q:脚本安全吗?
A:脚本拥有和 Obsidian 插件同级的权限,能读写仓库文件。只运行你自己写的或官方脚本库里的脚本;不要打开来源不明的「加载期脚本」和命令链接。
相关笔记
- 工具-06-编辑器与IDE:编辑器/IDE 的选择与配置,本文的「工具选型」思路与之互补
- 00-索引:本库总导航,绘图可以作为索引的可视化补充
- 关于本笔记库:写作规范与目录结构,新增绘图文件时参考命名约定
参考来源
- 插件仓库与 README:<https://github.com/zsviczian/obsidian-excalidraw-plugin>
- 官方中文 README(嵌入、链接、frontmatter、导出):<https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/docs/zh-cn/README.md>
- 官方脚本引擎文档(ExcalidrawAutomate 示例):<https://github.com/zsviczian/obsidian-excalidraw-plugin/blob/master/docs/zh-cn/docs/ExcalidrawScriptsEngine.md>
- 2.29.0 更新说明(CLI、Extras、新交互):<https://github.com/zsviczian/obsidian-excalidraw-plugin/releases/tag/2.29.0>
- Excalidraw 官方站点与文档:<https://excalidraw.com/>、<https://docs.excalidraw.com/>
- 说明:插件版本、设置项名称与菜单文案随版本变化,版本敏感内容以官方最新文档与插件设置页为准(本文对应 2.29.0)。