展开本页目录
开始前准备什么
- 解压lesson.zip到独立目录，先阅读README与运行范围。
- 使用与页面一致的工具版本；模型或账户能力以自己实际权限为准。
- 保留原始输入；教材中的人工参考与模型实际结果分开保存。
- 核对源文件与图片路径
- 导出基线PDF
- 修正可信素材路径
- 检查中文断行
- 检查备注与书签
- 对照实际渲染截图
- 归档可复现环境
下载完整练习素材 ZIP
含README、原创输入、提示词、校验脚本与明确标注的参考材料。
下载本页原始输入
export-requirements.md，原创练习数据或任务书。
查看运行说明与验证边界
具体步骤、命令与未执行范围。
1. 核对源文件与图片路径
阅读export-requirements.md，确认assets/device.svg存在。先导出坏例bad.md，观察本地资源访问限制或路径错误的实际日志；不要把空白占位图当正常。
bash
bash
python3 verify.py
2. 导出基线PDF
进入marp-project安装锁定CLI，运行baseline脚本，保存实际警告。浏览器渲染默认限制本地文件，是否加载成功必须查看PDF。
bash
bash
cd marp-project
npm install
npm run baseline3. 修正可信素材路径
使用good.md的相对assets路径。只对本包自有Markdown启用allow-local-files，避免把来源不明文件放进同一转换命令。
bash
bash
npm run pdf
4. 检查中文断行
在PDF第二页放大看长句，确认没有漏字、字体替代或最后一行裁切。用主题固定字号与内容宽度，保持句子意思，不靠截断省略错误。
5. 检查备注与书签
导出时加pdf-notes和pdf-outlines，打开PDF侧栏查看页签/标题，并检查备注附在对应页。不同阅读器显示方式不同，不能只看源Markdown是否写了备注。
6. 对照实际渲染截图
逐页比较baseline与fixed输出，确认产品图可见、中文完整、页数3。下载素材中的PDF和截图由锁定Marp命令真实输出，不是拼造的PDF界面。
bash
bash
python3 ../inspect-pdf.py fixed.pdf
7. 归档可复现环境
保留CLI版本、浏览器路径、CSS、本地素材和导出日志。PDF用于固定浏览；普通Marp PPTX通常为图片页，可编辑实验模式有额外依赖与版式限制。
怎样确认已经完成
- 自己的实际产物能打开，数字、标签、单位与原始输入一致。
- 执行随包verify.py检查真实文件；参考材料不能冒充自己的模型运行。
- 已运行Marp CLI 4.5.1生成基线与修正版PDF；已真实渲染固定版本的输出截图，未执行模型。
常见问题
下载素材后能直接看到AI生成结果吗？
已运行Marp CLI 4.5.1生成基线与修正版PDF；已真实渲染固定版本的输出截图，未执行模型。
Marp 中文PDF导出要怎样判断完成？
按本页步骤执行自己的工具环境，核对原始输入、实际产物与检查清单；下载成功、程序启动或参考文件存在都不能代替实际结果验收。