QUICKROUTER / PRACTICAL WORKBOOK

Marp 中文PDF导出

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

具体操作与命令

1. 核对源文件与图片路径
python3 verify.py

2. 导出基线PDF
cd marp-project
npm install
npm run baseline

3. 修正可信素材路径
npm run pdf

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

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

6. 对照实际渲染截图
python3 ../inspect-pdf.py fixed.pdf

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

2026-10-14 · 本页展示具体练习文件与核对依据；不伪造第三方软件界面或模型执行记录。