Image in Editor 插件,在编辑器里直接把图片、PDF、iframe、Excalidraw、引用笔记渲染出来

有一阵子，我是真心以为 Ozan 的 Image in Editor 这个插件要“退休”了。毕竟现在 Obsidian 自带的编辑器已经能直接预览图片，很多新用户一进来就会问：这玩意儿还有啥用？直到有天我写一篇长文，开着纯源码模式，满屏都是 ![[xxx.png]]、PDF 链接、iframe，一点画面感都没有，像在看服务器日志。那一刻我又把这个老伙计翻出来装回去了，心情就俩字：踏实。

这里有个关键点：

• 2.1.3 之后，不再支持旧版 legacy editor
• 现在只支持新编辑器的 Source Mode（源码模式）
• 如果你在用 Live Preview，插件会自动关掉所有渲染，避免重复显示一堆图片、PDF、Excalidraw

所以，它适合谁？很简单： 你喜欢在 Source Mode 下写 markdown，又希望眼睛看到的是“所见即所得”的那种大致效果，这插件就刚刚好。你既保留了干净的源码，又不用去预览里“翻译”自己刚写了啥。

具体能干嘛，拆开讲讲：

1. 本地图片 + 网络图片都能看正常的 ![](path)、![[xxx.png]]，都能在编辑器下面直接显示。 markdown 链接、Wikilink 两套语法都兼容，老用户不用改写笔记，新用户也不用纠结选哪种。

2. PDF、iframe、Excalidraw 直接嵌进来你有 PDF 手册、网页嵌入、在线图表、Excalidraw 草图，全都可以直接在编辑视图下面展开。写说明文档、读论文、记课堂笔记的时候特别爽，一边写一边看。

3. 支持本地文件路径（不在 vault 里的那种）这点我挺喜欢的。有些人图片是散落在 Downloads、桌面、外置盘里，不一定都搬进 vault。 插件支持用

   ![My Local File](file:////Users/mycomputer/Downloads/Images/IMG_1122.jpg)

   虽然从“长期整理”角度看不算优雅，但临时用一下非常方便。

• file:///
• app://local/这种前缀直接引用本地文件，比如：

4. msg、eml 邮件文件也能渲染（配合 MSG Handler 插件）2.1.8 之后，还多了个很硬核的功能：直接在编辑器里渲染 Outlook 的 .msg 和 .eml。 前提是你安装了另一个插件 MSG Handler，因为渲染引擎是靠它。用法也不复杂：

   ![[SomeMail.msg]]![[AnotherMail.eml]]

   如果你工作流里有大量邮件归档到 Obsidian，这个组合是真的实用。

5. 按需开关渲染类型设置里可以分别开关：

   也可以用命令面板的命令去切换，比如“Render All”。全局切换之后，有时需要重载一下 vault 才会完全生效。

• 图片
• PDF
• iframe
• 转录笔记（transclusion）
• Excalidraw

6. 配合 Style Settings 改样式如果你有装 Style Settings 插件，这俩还能联动。 比如设置 #small、#x-small 的最大宽度，或者转录内容、msg/eml 的最大高度，用来防止笔记被某一张巨图撑爆页面。

再说说安装和版本这块，放在中段，免得大家一上来就被操作吓跑。

Obsidian 里装它有两种路：

• 正常用户路线：

1. 打开设置 → 社区插件
2. 确认关闭安全模式
3. 在浏览里搜索 Ozan's Image in Editor 或 oz-image
4. 安装 → 启用 这种方式默认会装最新版本（比如 GitHub 上目前是 2.2.x 系列）

• 老版本 / legacy editor 用户： 你如果还在用老版编辑器，就要注意 README 里的提醒：

• 2.1.3 起已经砍掉 legacy editor 支持
• 想用旧编辑器，只能手动安装 2.1.2，这是最后一个兼容版本 做法大概是从 GitHub Releases 里下载对应版本的 zip，然后放进 .obsidian/plugins 对应文件夹。这个操作稍微偏折腾，如果你完全不熟命令行和文件夹结构，个人建议还是升级到新编辑器，世界会清净很多。

新老版本的区别，可以简单记成一句：

新编辑器 Source Mode + 想要编辑时就能看见图，就用它。 念旧的 legacy editor，只能停在 2.1.2。

关于使用体验，我自己的感受是这样的：

• 如果你已经完全爱上 Live Preview，其实这个插件存在感会比较低，因为核心功能有点重叠
• 但你要是偏爱“纯源码＋即时画面”的组合，像写代码那样写文档，插件就会变成很核心的工具
• 另外它对那些重度用 PDF、Excalidraw 的人很友好，不会让你陷入“切预览、再切回来”的循环地狱

Obsidian 生态发展到现在，很多功能都开始“撞车”，但像这种围绕 Source Mode 打磨体验的小插件，还是挺有存在意义的。喜欢纯文本、又不想放弃视觉反馈的人，装上它会很舒服。