w wyl123ly 的博客
MD

工具-09-Excalidraw绘图

55 KB 2026.10.18 原文件

工具-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 安装

本仓库已经安装并启用了该插件,下面是复现步骤:

  1. 打开 设置 → 第三方插件(社区插件),关闭「受限模式(Restricted mode)」(旧版叫「安全模式」)。
  2. 点「浏览」,搜索 Excalidraw,作者是 Zsolt Viczian(插件 ID:obsidian-excalidraw-plugin)。
  3. 安装后启用。左侧功能区出现一支铅笔图标,文件资源管理器里也能右键新建绘图。
  4. 建议同时把插件固定在侧边栏:右键功能区图标 →「固定」。

插件很大,且更新频繁

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/ScriptsExcalidrawAutomate 脚本目录
素材库存储位置仓库文件(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 新建与命名

三种新建方式,效果相同:

  1. 点左侧功能区的铅笔图标。
  2. 命令面板(Ctrl+P)执行 Excalidraw: 新建绘图文件。
  3. 在文件资源管理器里右键文件夹 →「新建 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用来做幻灯片/导出区域
便签N2.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 的代码块,目的是:

  1. 文件体积更小;
  2. 避免大段明文 JSON 污染 Obsidian 的全文搜索;
  3. 减少同步冲突时的合并体积。

需要看/改 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-pluginparsed必需,标记这是绘图
tags任意标签,如 [excalidraw, 算法]
excalidraw-default-modenormal / zen / view打开这张图时的模式
excalidraw-open-mdtrue / false默认用 Markdown 视图打开
excalidraw-embed-mdtrue / false被嵌入时显示 Markdown 面而不是图
excalidraw-autoexportnone / both / svg / png单张图的自动导出策略
excalidraw-export-transparenttrue / false导出透明背景
excalidraw-export-darktrue / false导出深色/浅色版本
excalidraw-export-padding数字导出边距(像素)
excalidraw-export-pngscale0.5–5PNG 导出倍率
excalidraw-export-embed-scenetrue / false导出图片时嵌入场景数据
excalidraw-link-prefix字符串,如 "📍 "内部链接在画布上的前缀
excalidraw-url-prefix字符串,如 "🌐 "外部链接前缀
excalidraw-link-bracketstrue / false画布上是否显示 [[ ]]
excalidraw-fontVirgil / Cascadia / 字体文件嵌入 Markdown 时的字体
excalidraw-embeddable-themedark / light / auto / default嵌入内容(如 PDF)的主题

让属性自动补全

设置里开启 「将 Excalidraw 属性加载到 Obsidian 的自动提示中」(需重启插件),之后在 frontmatter 里输入 excalidraw- 就有补全和说明。


六、把图嵌进笔记

6.1 三种方式

方式一:用命令(推荐给新手)

  1. 打开要插图的那篇笔记;
  2. 命令面板执行 Excalidraw: 嵌入绘图 (图:drawing) 到当前 Markdown 文档中;
  3. 选择已有绘图,或输入新文件名(命令会自动创建)。
  4. 也可以一步到位: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 元素链接

给图形本身挂链接,适合做「可点击的索引图」:

  1. 选中一个元素(矩形、图片、文本都行);
  2. 按 Ctrl+K,或右键 →「添加链接」,或命令 Excalidraw: 以链接形式插入文件;
  3. 输入 笔记名、笔记 或网址;
  4. 之后按住 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

具体做法:

  1. 建一张 知识地图-线性代数.excalidraw.md;
  2. 画若干圆角矩形代表章节,文字写 3-1-向量空间 这样的链接;
  3. 给每个矩形挂元素链接,指向对应笔记;
  4. 用分组把相关章节框在一起,之后在笔记里用 #^group= 引用;
  5. 把这张图嵌入 00-索引 或课程主页;
  6. 以后每新增一篇笔记,就在图上加一个节点——图会自然变成你的「目录」。

八、把内容嵌进画布

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,以设置页显示为准。

来源默认拖入CtrlShiftCtrl+Shift
本地文件(系统)导入到仓库链接形式插入图像形式嵌入交互形式嵌入
浏览器按 URL 引用图片/缩略图链接形式插入导入到仓库交互形式嵌入

从 Obsidian 内部(文件资源管理器、其他笔记)拖到画布时,键位不一样:

内部拖动结果
默认链接形式插入
Shift图像形式嵌入
Ctrl+Shift交互形式嵌入(MD-Embeddable)
Ctrl+Alt图像形式嵌入(100% 尺寸)

修饰键冲突会「看起来没反应」

插件不会检查你的组合是否和 Obsidian 快捷键冲突。改过之后如果某个动作失效,先恢复默认,再逐个加。


九、模板、素材库、画笔

9.1 模板

模板决定新绘图的默认样式:描边颜色、填充、字体、字号、线宽、粗糙度、画布背景,甚至调色板。

创建模板:

  1. 新建一张空白绘图,调好你想要的样式(比如蓝灰配色、Cascadia 字体、细线);
  2. 在设置 「Excalidraw 模板文件」 里把路径指向这张绘图(可直接输入,或用路径建议列表选择;本库当前是 Excalidraw/Template.excalidraw,但文件不存在);
  3. 之后新建绘图会自动套用这些样式。

模板也可以是文件夹

把该设置指向一个文件夹,新建绘图时会让你选择用哪个模板。适合「算法图模板」「读书卡片模板」「演示模板」多套并存。

模板负责的是样式与画布设置的继承,不会替每张新图设置打开模式。想让某张图默认以查看模式打开,直接在该图的 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(实验性):

  1. 开启「启用 AI 功能」(重启 Obsidian 后生效);
  2. 在「定义可用的提供商」里配置 provider:OpenAI、Anthropic/Claude、Google/Gemini、xAI/Grok、OpenAI 兼容/本地;
  3. 填 API Key 和 base URL;本地模型可填一个占位 Key;
  4. 选择默认的文本与多模态模型、图像模型;
  5. 「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 题为例:

  1. 新建 算法图解-加分二叉树.excalidraw.md;
  2. 画中序序列和若干子树区间,用矩形 + 绑定文字表示状态;
  3. 用箭头标出「枚举根节点 → 划分左右子树」的转移;
  4. 给每个关键步骤的图形挂元素链接,指向题解笔记的对应标题;
  5. 在题解笔记顶部嵌入整张图:(图:算法图解-加分二叉树.excalidraw);
  6. 在「转移方程」一节点用 !... 只嵌该局部;
  7. 复习时先看图,想不起来再点元素链接跳回题解。

用画框分步

一张图里放 4 个画框,分别是「定义状态」「转移」「边界」「答案」,复习时缩放至画框逐个看,比一张大图更清楚。

13.2 课程概念图

以 3-1-向量空间 为例:

  1. 中心放「向量空间」,四周放「子空间」「基」「维数」「线性映射」;
  2. 每个节点写 笔记名,并挂元素链接;
  3. 用不同颜色区分「定义」「定理」「例子」;
  4. 把图嵌入课程索引笔记;
  5. 学期末用 #^group= 把某一章的分组单独抽出来做复习卡片。

13.3 日记与会议白板

以 2026-10-10 这类日记为例:

  1. 当天新建一张白板,记录待办、想法、草图;
  2. 待办用便签(N)或文本的 - [ ];
  3. 会议白板里给「行动项」挂链接,指向项目笔记;
  4. 把白板嵌回日记:(图:2026-10-10 白板.excalidraw);
  5. 周末翻日记时,图比文字更容易唤起记忆。

13.4 读书视觉笔记

以 被讨厌的勇气 为例:

  1. 画「目的论 vs 原因论」的对比图;
  2. 每个概念旁写书中的原话(文本元素,便于搜索);
  3. 用箭头表示「课题分离 → 共同体感觉」的递进;
  4. 书评笔记里只放图 + 几段文字,图承担结构,文字承担论证;
  5. 用 #^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+0100% 缩放
?打开快捷键帮助面板
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 模式切换桌面/紧凑/托盘

十六、练习题

  1. 基础题:新建一张绘图,画三个矩形并用箭头连接,给中间那个矩形加一个指向 00-索引 的元素链接,再把整张图嵌入到任意笔记里,宽度设为 500。
  2. 进阶题:给一张图里的两个相关元素编组,然后从笔记里用 #^group= 只嵌入这个分组,并比较它和 #^area= 的效果差异。
  3. 进阶题:写一个脚本,把所有选中文本元素的字号统一改成 20,并把描边颜色改成当前主题色。
  4. 思考题:什么情况下应该用 Mermaid,什么情况下应该用 Excalidraw?举一个你实际遇到的场景,并说明如果换成另一种工具会损失什么。
  5. 综合题:给你正在学的一门课做一张「知识地图」,要求包含至少 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)。