Contents and export ZH

目录与导出

文档首页 · English

目录

独立段落写 [toc]，或使用带深度的代码块：

```academic-toc
3
```

支持深度 1–6，省略则用设置值。笔记中的目录可点击；PDF 目录的页码通过实际打印测量得到，并建立 PDF 书签。

PDF / HTML 导出

无需安装导出引擎。运行「直接导出当前笔记为 PDF」或「导出当前笔记为 HTML 快照」。HTML 是静态快照；修改笔记后需要重新导出。

多篇导出运行「选择多篇笔记并导出合订本 PDF」，勾选文件、调整顺序和标题。也可创建清单笔记：

---
phb-book:
  title: Analysis Notes
  subtitle: A sample collection
  tocDepth: 3
  files:
    - 第一章.md
    - path: 第二章.md
      title: 第二章：连续映射
---

phb-book 是笔记顶部 YAML 属性里的合订本章节清单，不是目录或额外插件。单篇直接导出不需要它；也可以使用多篇选择窗口而不写清单。

打开清单运行「按 phb-book 清单导出 PDF」或 HTML 命令。路径相对库根目录，按清单顺序组章；清单本身不作为章节。

合订本编号有三种：章.节.序号（默认，如 2.3.1）、章.序号（章内连续，如 2.1）、保留库内显示编号（可能跨章重号）。无 H2 或首个 H2 前，在章.节模式属于第 0 节。前两种在导出副本中重新编号，原笔记不变。跨文件目标要纳入本次导出，否则报告提示未解析引用。

「PDF 捕获当前主题与片段样式」开启时复制当前 CSS，关闭时用内置数学框、图表和打印样式；都保留当前浅深模式和色板。折叠框展开，长框允许跨页，过宽 SVG 公式按可用宽度缩放。

默认输出到库内 _exports/；只能使用库内相对目录，不能使用绝对路径或 ..。生成带时间戳的 HTML 快照、快照报告、PDF 和分页校验报告。最多进行 6 轮目录校准，未收敛、图片/公式/字体错误或内部链接无效时停止输出，不猜测页码。

图片跨页保护

PDF 使用 A4 页面。能放进一页的整幅图、子图组和图注会保持在一起；当前页剩余空间不足时移到下一页。超高图会按比例缩小到页面可用高度，普通图片也有保护。若图注本身过长，缩小图片后仍超过一页，则允许长图注分页。报告中的 mediaPagination 记录保护组数、缩放组数和仍过大的组数。

图片浮动排版（实验）

桌面版进入「设置 → Academic Notes → 目录与导出 → 图片排版优先级（实验）」。默认“直接留白（关闭）”，可选：

优先级	行为
缩至 80% → 移动 → 留白	先把图片宽高缩至 80%；整组能放入当前页就保留原位置，否则尝试用后文填补空白。
移动 → 缩至 80% → 留白	先尝试让后文提前，再尝试缩图。
仅缩至 80%	缩图能放下就缩，否则保留原顺序。
仅移动	尝试让后文提前，否则保留原顺序。

移动只允许独立 figure／fig 后面最多三个连续普通段落提前，完整图片与图注留在下一页；遇到标题、数学环境、列表、表格或其他图片立即停止。环境内部的图片不移动，也不会移入其他环境。使用实际 PDF 测量验证完整图片和提前段落的首尾；若跨页则拒绝这次调整。图注字号保持不变，原笔记和编号顺序不改写。

“最大图片调整次数”可设为 1、3、6（默认）或 10，限制整次导出的试调总次数。超过次数后若仍需调整，会撤销本次全部实验调整，恢复正常留白。目录校准后再次检查；若边界改变或实验布局导致目录不稳定，同样恢复正常排版。正常排版的目录若仍校准失败，会报告导出错误。分页报告的 figureLayout 包含试调、缩图、移动、跳过计数与回退原因。

这是针对显式图环境的有限实验。独立交换图、未包进环境的图片、表格和很长的文字图注不自动浮动，仍使用常规跨页保护。HTML 快照保持原顺序。合成示例见 examples/figure-floating.md。

保存和重开合订本方案

在桌面或移动端运行 新建或编辑合订本清单，勾选章节、调整顺序和章节标题，填写合订本标题、副标题及目录深度，再指定库内路径并 保存清单。保存结果是普通 phb-book 笔记，不会覆盖其他普通笔记。打开清单后再次运行该命令即可继续编辑；也可以填写路径后点 载入合订本清单。更新保留其他属性及正文，也会尊重打开的未保存编辑内容。

检查学术引用 会检查所选章节；导出 PDF／HTML 前也会先检查，有问题时需查看后选择 仍然导出。进度窗口新增 取消导出，覆盖快照准备和 PDF 打印阶段；已完成保存的快照／报告会保留。宿主原生 Markdown 渲染会先结束当前操作，再响应取消检查点。只关闭窗口不会取消。PDF 仍仅限桌面，移动端可编辑清单及导出 HTML。