图片是否清晰，主要由源图像的像素或矢量信息决定；题注和交叉引用能否自动更新，则取决于 Word 中是否存在 SEQ、REF 等字段。Markdown 转 DOCX 可以完成图片嵌入和静态编号，但如果交付后的 Word 还要频繁增删图片，应在 Word 中使用原生题注与交叉引用。
先区分四个概念
| 概念 | 决定什么 | 常见误区 |
|---|---|---|
| 源图像像素 | 放大和打印时的细节 | 把低分辨率截图标成 300 dpi 就会变清晰 |
| Word 中显示尺寸 | 图片在页面上占多宽 | 拖大图片等于增加细节 |
| 题注字段 | 图 1、图 2 的自动编号 | 手写“图 1”也能自动更新 |
| 交叉引用字段 | 正文引用与目标的关联 | 手写“见图 3”能随增删图片更新 |
pandoc --dpi 用于没有尺寸信息的位图在输出中的尺寸换算，并不会给图片创造新的像素。清晰度不足时应回到原图重新导出。
路线一：以 Markdown 为源文件
适合程序化生成、每次都从 Markdown 重新构建文档的场景。
建议目录：
report/
report.md
template.docx
figures/
pipeline.png
architecture.svg
基础转换：
pandoc report.md -o report.docx --resource-path=".;figures" --reference-doc=template.docx
需要在 Markdown 源文件中维护图表编号时，可以使用 pandoc-crossref：
pandoc report.md -o report.docx --filter pandoc-crossref --reference-doc=template.docx
pandoc-crossref 可以在生成阶段编号并引用图表，但 DOCX 中的结果通常不等同于 Word 原生题注和交叉引用字段。后续若直接在 Word 中插入、删除或移动图片，静态编号不会自动完整重排。它更适合“修改源文件后重新生成”的工作流。
路线二：以 Word 为最终维护文件
适合论文、报告和交付文档在 Word 中继续多人修改的场景。
- 插入原始图片，避免从聊天窗口或预览页面截图；
- 在“文件 → 选项 → 高级 → 图像大小和质量”中根据交付要求决定是否压缩；
- 选中图片，进入“引用 → 插入题注”，选择“图”或自建标签；
- 统一修改 Word 的“题注”样式；
- 在正文使用“插入 → 交叉引用”，选择对应图，并勾选插入为超链接；
- 完成编辑后按
Ctrl+A、F9更新题注与引用字段； - 使用“引用 → 插入表目录”生成图目录。
Microsoft 官方文档说明，Word 题注编号由字段生成，移动或删除图片后可以统一更新；交叉引用通过隐藏书签关联目标。
图片清晰度怎么控制
- 照片和截图使用足够像素的 PNG/JPEG；按最终页面宽度评估，不用文件属性里的 dpi 数字代替像素检查；
- 线条图、流程图和架构图优先保留 SVG 等矢量源，同时准备兼容性良好的高分辨率 PNG 备用；
- Word 的“不压缩文件中的图像”可以减少保存时的额外降采样，但不能恢复已经丢失的像素；
- 图片替换时使用“更改图片”或重新插入原文件，不从微信预览、网页缩略图或 PDF 截图取图；
- 导出 PDF 后在 100% 和 200% 缩放下检查文字、细线、透明背景和颜色。
验收清单
- 在 Word 中新增一张图，检查后续题注是否能更新；
- 点击正文交叉引用，确认能跳到对应图片；
- 按
Alt+F9检查需要维护的题注和引用是否为字段； - 断开网络后打开文件，确认图片不是易失效的外部链接；
- 导出 PDF 并检查图片清晰度、页内位置和图目录页码；
- 记录最终使用 Word 维护还是从 Markdown 重新生成，避免两套编号同时成为“真源”。
参考资料：Microsoft：添加、设置或删除题注、Microsoft：创建交叉引用、Microsoft：图像大小与质量、Pandoc User’s Guide、pandoc-crossref 文档及其 DOCX 原生交叉引用讨论。
