# Marp 中文PDF导出

已运行Marp CLI 4.5.1生成基线与修正版PDF；已真实渲染固定版本的输出截图，未执行模型。

1. 核对源文件与图片路径
阅读export-requirements.md，确认assets/device.svg存在。先导出坏例bad.md，观察本地资源访问限制或路径错误的实际日志；不要把空白占位图当正常。
python3 verify.py

2. 导出基线PDF
进入marp-project安装锁定CLI，运行baseline脚本，保存实际警告。浏览器渲染默认限制本地文件，是否加载成功必须查看PDF。
cd marp-project
npm install
npm run baseline

3. 修正可信素材路径
使用good.md的相对assets路径。只对本包自有Markdown启用allow-local-files，避免把来源不明文件放进同一转换命令。
npm run pdf

4. 检查中文断行
在PDF第二页放大看长句，确认没有漏字、字体替代或最后一行裁切。用主题固定字号与内容宽度，保持句子意思，不靠截断省略错误。


5. 检查备注与书签
导出时加pdf-notes和pdf-outlines，打开PDF侧栏查看页签/标题，并检查备注附在对应页。不同阅读器显示方式不同，不能只看源Markdown是否写了备注。


6. 对照实际渲染截图
逐页比较baseline与fixed输出，确认产品图可见、中文完整、页数3。下载素材中的PDF和截图由锁定Marp命令真实输出，不是拼造的PDF界面。
python3 ../inspect-pdf.py fixed.pdf

7. 归档可复现环境
保留CLI版本、浏览器路径、CSS、本地素材和导出日志。PDF用于固定浏览；普通Marp PPTX通常为图片页，可编辑实验模式有额外依赖与版式限制。


官方来源：https://github.com/marp-team/marp-cli