失败与排查
导出失败几乎都能归到四类：超时、页码被裁、原生导出限制、平台不支持。下面按症状查。
症状对照表
| 症状 | 原因 | 处理 |
|---|---|---|
| 对话框关闭，弹出了原生保存框 | 导出超时，已回退原生导出 | 调大「导出超时」，或拆分长文档 |
| 页码被裁掉一半 | 页边距小于 11mm | 页码放页尾就加大下边距，放页眉就加大上边距 |
| 分页预览一直转圈 | 正在真打印临时 PDF | 等；长文档会慢，可先用版式预览 |
| 导出后没有分页优化 | 用的是原生导出，不是 AutoGallery | 从命令面板或文件菜单重新导出 |
| 命令是灰的 | 当前文件不是 Markdown，或不在桌面端 | 切到 Markdown 笔记；移动端不支持导出 |
| 图片位置和屏幕不一样 | 版心宽度与屏幕宽度不同 | 这是预期行为，按纸张重排 |
超时与回退
默认超时 60 秒。超时后：
- 关闭导出对话框；
- 回退到 Obsidian 原生 PDF 导出；
- 用 Notice 告知。
先关对话框是为了避免同时出现两个保存框。回退后得到的是原生结果，分页优化不会生效。
如果长文档经常超时，可以把超时调到 120–180 秒，或者按章节拆成多篇再导出。
原生导出的限制
设置页里有一组标着「在 Obsidian 原生 PDF 导出中生效」的选项。它们能起作用，但只能部分运行；原生导出使用隐藏弹窗，没有可测量的视口，所以：
- 图片尺寸与浮动仍会按版心重算；
- 但分页优化（贴底压缩、孤行回收）无法完整执行。
要完整效果，用 AutoGallery 的导出。
版式预览与分页预览的差异
| 现象 | 说明 |
|---|---|
| 版式预览里一行没被拆开，分页预览里被拆了 | 版式预览不分页，看不到页边界 |
| 分页预览的字比版式预览小 | 分页预览是真 PDF 的渲染结果，按实际纸张缩放 |
| 两者图片宽度不同 | 版式预览沿用屏幕栏宽，分页预览用版心宽度 |
判断「最终会印成什么样」，只看分页预览。
导出后的检查清单
- 第一页有没有多余的标题（
包含笔记标题开关）。 - 页码是否完整（尤其首页与末页）。
- 画廊行有没有被拆开。
- 末页是不是只有一两行（孤行控制没开）。
- 奇偶页的内外边距是否对称。