兼容性
Obsidian 1.5 起、桌面与移动同一份代码。PDF 导出只在桌面端可用。
版本与平台
| 项 | 支持情况 |
|---|---|
| Obsidian 最低版本 | 1.5 |
| 桌面端 | Windows / macOS / Linux |
| 移动端 | iOS / Android（除 PDF 导出外功能一致） |
| 实时预览 | 支持，手势与手柄仅在此模式 |
| 阅读视图 | 支持，绕排效果以此为准 |
| 源码模式 | 不接管 |
功能可用性矩阵
| 功能 | 桌面 | 移动 | 阅读视图 | 实时预览 |
|---|---|---|---|---|
| 画廊 | 是 | 是 | 是 | 是 |
| 宽度路由 | 是 | 是 | 是 | 是 |
| 浮动绕排 | 是 | 是 | 是 | 否（只留位置） |
| 裁剪参数 | 是 | 是 | 是 | 是 |
| 裁剪对话框 | 是 | 是 | 否 | 是 |
| 拖拽调宽 | 是 | 触屏 | 否 | 是 |
| 画廊手柄 | 是 | 触屏 | 否 | 是 |
| PDF 导出 | 是 | 否 | — | — |
已知限制
- 实时预览不做正文绕排。 为了编辑光标稳定，图片只占位，文字不绕。判断绕排效果请看阅读视图。
- Callout 不接管。 见嵌套作用域。
- 表格单元格只有裁剪生效。 宽度由列决定。
- 原生 PDF 导出只能部分生效。 隐藏弹窗没有可测量视口，分页优化跑不全。用 AutoGallery 导出。
- 移动端没有 PDF 导出。 依赖桌面端的打印能力。
- 图片尺寸缓存按笔记维护。 新加入的图片第一次渲染时可能有一帧的宽度跳动，之后稳定。
与主题的关系
插件只改图片容器的宽度、对齐与 object-fit，不覆盖主题的字体与颜色。因此：
- 换主题不会破坏排版，只会改变字号与背景。
- 自定义 CSS 里若对
.image-embed设了width: 100%，可能与插件的百分比冲突；这是设计约束，不是 bug。
与其它插件的关系
| 类型 | 影响 |
|---|---|
| 图片管理类（重命名、压缩） | 无冲突，插件按路径引用 |
| 导出类（Pandoc、其它 PDF 工具） | 它们不经过本插件的导出管线，排版可能不同 |
| 主题类 | 见上 |