• 您可以使用以下格式选项自定义嵌入图像的大小和位置：
  • ![[image.excalidraw|100]],
  • ![[image.excalidraw|100x100]],
  • ![[image.excalidraw|100|left]],
  • ![[image.excalidraw|right-wrap]].
  • ![[<filename.excalidraw>|<width>x<height>|<alignment>]].
  • 您可以通过 CSS 添加自定义对齐方式。
  • 出现在 <alignment> 中的任何文本都将添加到呈现的 SVG 元素样式和包装器 DIV 元素中。
  • 有关更多信息，请参见 styles.css。
• Excalidraw 绘图在 Obsidian Publish 中不显示。如果您想在发布的文档中使用 Excalidraw，您可以在插件设置中配置，在创建新文件时自动在文档中插入绘图的 PNG 或 SVG 版本。请参见“要插入到文档中的文件类型”。
  • 在“导出设置”下，您还可以配置自动导出图像的暗色和亮色版本，以便您的发布站点支持暗色和亮色模式。

超链接和拖放支持

超链接

• 支持超链接，例如：
  • https://zsolt.blog,
  • [Obsidian](https://obsidian.md), 和
  • 内部链接，例如在绘图文本中的 [[My file in vault|Alias]]。
• 如果你启用了 Obsidian 设置中的 Files & Links/Automatically Update Internal Links，当文件被移动或重命名时，链接将会更新。
• 绘图中的链接将会显示在文档的反向链接中。
• 支持引用插入
  • ![[myfile#^blockref]] 将会在绘图中转换为引用的块的文本。
  • ![[myfile#section]] 也可以使用，这将会引用该部分。
  • 你还可以通过在转入后的文本后面加上花括号中的最大字符数来指定引用文本的换行，例如 ![[myfile#^blockref]]{40} 将会在 40 个字符处换行。
• 为了方便起见，你还可以使用命令面板在绘图中插入链接。
• CTRL/CMD + 悬停 可以弹出 Obsidian 的快速预览链接。（在 Mac 上是 CTRL+CMD+ 悬停）。
• 使用块引用，你还可以在其他文档中引用和插入出现在绘图中的文本。

拖放支持

• 您可以从 Obsidian 文件浏览器中拖动文件，并将它们变成 Excalidraw 中的文件链接。有关各种修饰键组合，请参见上表。
• 注意：将图像锚定到其大小的 100% 是一个非常特定的行为，我主要是为自己构建的一个非常专业的功能
  • （甚至比 Excalidraw Obsidian 中的其他功能更多 - 也主要是为了自己😉）。
  • 每次打开 Excalidraw 绘图时，这将重置您嵌入的图像为 100% 大小， 或者如果您使用此功能插入了一个嵌入的 Excalidraw 绘图到您的画布上， 每次更新嵌入的绘图，它都会被缩放回 100% 大小。
  • 这意味着即使您在绘图上调整图像的大小，下次打开时它也会重置为 100%， 文件或修改原始嵌入对象。当您将绘图分解为单独的 Excalidraw 文件时，此功能非常有用， 但当组合到单个画布上时，您希望各个部分保持其实际大小。我使用此功能来 从原子绘图构建“一页书”摘要。
• 您可以从 Markdown 视图中拖放文本到 Excalidraw。
• 您可以从浏览器中拖放网址，并将它们变成链接。
• 您可以拖放 YouTube 链接和缩略图，并在 Excalidraw 中将它们变成带有缩略图的 YouTube 链接。

LaTeX

使用命令面板操作 ” 插入 LaTeX 公式 ” 来插入 LaTeX 公式。

您可以在 Markdown 视图中编辑公式，或者通过CTRL/CMD + 单击公式进行编辑。

图片支持

• 在 iOS 和 Android 上，您可以通过在 Excalidraw 中按下添加图片按钮来从相机中添加图片。
• 您可以将图片复制/粘贴到您的绘图中。图片将保存在您的保险库中。
• 您可以按照上述说明拖放图片。
• 网络上的图片的 URL 链接：您可以从网页上将图片拖放到 Excalidraw 中。如果您在将图片拖放到 Excalidraw 时按住 CTRL 键，图片将不会保存到您的保险库中。Excalidraw 将从 URL 加载图片。请注意，如果您没有互联网访问权限，或者这些图片从互联网上被删除，它们也将从您的绘图中消失。
• 如果您将图片 URL 粘贴到 Excalidraw 中（只需单击 URL 上的复制，然后在 Excalidraw 画布上单击粘贴），图片将被插入并带有指向网络上图片的链接。同样，图片不会保存到您的保险库中，只有链接。
• 如果您拖放一个 YouTube 视频链接，它将被转换为带有指向视频的缩略图链接的元素。

引用图像的部分块

有关详细信息，请参见此 视频

• 当在指向 Excalidraw 文件的链接中引用画布上的元素时，
  • 使用 elementId 或部分标题（即包含 # <Section title> 的文本元素）
    • 例如 [[file#^elementID]]，
  • 您可以添加 group= 前缀，
    • 例如 [[file#^group=elementID]] 或
  • area= 前缀，
    • 例如 [[file#area=Section heading]]。
  • 如果找到 group= 前缀，Excalidraw 将选择与 elementID（块引用）或部分标题引用的元素相同组中的元素组。
  • 如果找到 area= 前缀，Excalidraw 将在引用元素周围插入图像的剪切。
  • 请注意，在将 Excalidraw 嵌入为 PNG 到您的 Markdown 文档时，不支持 area= 选择器。
  • 引用文本元素的 elementID 而没有 group= 或 area= 前缀将将元素作为纯文本插入。引用非文本元素（例如矩形，椭圆等）而没有 group= 或 area= 前缀将导致 Obsidian 错误，因为这些 elementId 在 Excalidraw markdown 文件中不存在作为块引用。

Markdown

• 从 1.2.0 版本开始，绘图文件存储在 Markdown 文件中
  • 您可以为绘图添加标签
  • 您可以在绘图的 YAML 前置元数据中添加元数据
  • 在前置元数据和 # Text Elements 标题之间添加的任何内容都将被 Excalidraw 忽略，即您可以在此处添加任何内容，它将作为文档的一部分保留。
  • Excalidraw 文档现在以图形视图显示。
  • 以下前置元数据键将自定义绘图的显示方式 - 覆盖常规设置：
    • excalidraw-link-prefix: "📍" 内部链接的预览前缀
    • excalidraw-url-prefix: "🌐" 外部链接的预览前缀
    • excalidraw-link-brackets: true|false 是否在预览中显示链接周围的括号
    • excalidraw-default-mode: view|zen 默认情况下以查看模式或禅模式打开此文档。默认查看模式非常适合演示幻灯片。
  • 前置元数据标签可自定义文件级别的图像导出 519。如果存在这些键，则它们将覆盖默认的 excalidraw 嵌入和导出设置。
    • excalidraw-export-transparent: true： true 透明 / false 带背景。
    • excalidraw-export-dark: true 暗模式 / false 亮模式。
    • excalidraw-export-padding: 指定图像的导出填充
    • excalidraw-export-pngscale: 这仅影响导出为 PNG。指定图像的导出比例。典型范围在 0.5 和 5 之间，但您也可以尝试其他值。

将完整的 Markdown 文件嵌入到您的绘图中

• 从 Obsidian 文件浏览器中拖动所需的文件，并在将文件放置在画布上时按住SHIFT键。
• 使用命令面板操作：从vault插入markdown文件
• 使用自定义的 woff、woff2 或 TTF 字体来显示文档，您可以在 Excalidraw 设置中设置要使用的默认字体。
• 您可以为渲染 Markdown 文档的快照图像设置自定义 CSS。 仅支持操作系统标准字体作为字体系列（ Win10, Mac & iOS ），此外，您可以使用上述设置来设置一个额外的自定义字体。
  • （观看此 视频 以进行演示，并查看此
  • 示例CSS）。
  • 为了帮助样式化，您可以观察由 Excalidraw 创建的 Markdown 文档的 SVG 快照。
    • 打开 Obsidian 开发者控制台（CTRL+Shift+i/CMD+OPT+i）并
    • 执行以下命令：ExcalidrawAutomate.mostRecentMarkdownSVG
• 您可以通过将以下前置元数据键添加到您的 Markdown 文档中来控制嵌入的 Markdown 文件的外观：
  • excalidraw-font: Virgil|Cascadia|font_file_name.extension
  • excalidraw-font-color: css-color-name|#HEXcolor|any-other-html-standard-format，
    • 您可以在 这里 找到 CSS 颜色名称。
  • excalidraw-border-color: css-color-name|#HEXcolor|any-other-html-standard-format
  • excalidraw-css: "css-filename|css snippet"
• 切换到 Markdown 视图或使用WIN+CTRL/CMD+CTRL点击图像以编辑嵌入的属性：
  • [[filename#^blockref|WIDTHxMAXHEIGHT]]

自定义字体、自定义笔、OCR 支持、SVG 导入

• 在插件设置中，您可以添加自定义的第四种字体。更多详细信息请参见此 视频
• 该插件包括使用 Taskbone OCR 的 OCR 支持。更多详细信息请参见此 视频
• 您可以将 SVG 文件转换为 Excalidraw 绘图（有一些限制）。更多详细信息请参见此 视频
• 您可以定义自定义的自由绘制笔。请参阅 此处 的文档和 视频。

脚本引擎

• 从 1.5.0 版本开始，您可以使用脚本引擎轻松执行 ExcalidrawAutomate 宏，并为它们分配命令面板快捷方式。您可以在 这里 找到一个入门视频和一个不断增长的可安装脚本库。
• 您可以通过将脚本和相应的 SVG 图标文件移动到文件夹中，在 Excalidraw 的 Obsidian 工具面板上将脚本组织成组。请参见演示 视频。

其他

• 左手模式
• 包括完整的
  • QuickAdd,
  • Templater 和
  • Dataview 支持通过 ExcalidrawAutomate。
  • 查看 详细帮助和示例。
  • 我还有一个 YouTube ExcalidrawAutomate 播放列表，有很多示例。
• 需要 OBSIDIAN SYNC 订阅：完整的绘图文件历史记录和设备间同步
• 多语言支持：如果您想通过翻译插件来帮助，请与我联系。

反馈、问题、想法、问题

加入关于 Excalidraw 插件的讨论，访问 forum.obsidian.md

请前往 GitHub 报告错误或请求改进。

如果您喜欢 Excalidraw，请通过在 https://ko-fi/zsolt 上给我买杯咖啡来支持我的工作和热情。

请还帮忙通过在 Twitter、Reddit 或其他您经常使用的社交媒体平台上分享 Obsidian Excalidraw 插件的信息来传播。

您可以在 Twitter 上找到我 @zsviczian，以及在我的博客 zsolt.blog 上。

Excalidraw 的朋友们

如果你喜欢 Excalidraw，请考虑尝试一下 ExcaliBrain（也可通过 Obsidian Community Plugins 获得）。