展开本页目录
开始前准备什么
- 解压lesson.zip到独立目录，先阅读README与运行范围。
- 使用与页面一致的工具版本；模型或账户能力以自己实际权限为准。
- 保留原始输入；教材中的人工参考与模型实际结果分开保存。
- 核对五页教学目标
- 安装固定Marp CLI
- 识别全局主题与分隔符
- 查看真实HTML演示
- 加入仅讲者可见的备注
- 生成PDF并打开
- 保存源文件与真实产物
下载完整练习素材 ZIP
含README、原创输入、提示词、校验脚本与明确标注的参考材料。
下载本页原始输入
course-outline.md，原创练习数据或任务书。
查看运行说明与验证边界
具体步骤、命令与未执行范围。
1. 核对五页教学目标
阅读course-outline.md，明确最后一页答案是登记缺件。AI可以协助压缩文字，但素材内的人工slides.md是可独立复现的源文件。
bash
bash
python3 verify.py
2. 安装固定Marp CLI
在marp-project目录安装@marp-team/marp-cli 4.5.1。工程只写练习目录，避免更改业务项目依赖；HTML导出先验证命令可用。
bash
bash
cd marp-project
npm install
npm run html3. 识别全局主题与分隔符
打开slides.md，检查marp:true、theme和paginate。用---分隔五页，每页保留短标题与两三条要点，不用一页塞完整提纲。
4. 查看真实HTML演示
打开生成的training.html，逐页前进检查页码、中文与最后练习。文字超框时先减信息量或拆分，不能只缩到难读。
5. 加入仅讲者可见的备注
把讲解提醒放到Marp支持的注释备注中。观众正文只留操作要点；查看导出的讲稿，检查备注跟随正确页码。
bash
bash
npx marp slides.md --notes -o notes.txt6. 生成PDF并打开
安装可用浏览器后用同一源文件导出PDF，打开检查五页。若Chrome路径自动识别失败，按CLI浏览器参数配置自己的浏览器。
bash
bash
npm run pdf
7. 保存源文件与真实产物
一起保留slides.md、主题CSS、HTML/PDF和notes.txt。文件由Marp实际渲染，内容为人工教学源稿，不称作AI生成成果。
怎样确认已经完成
- 自己的实际产物能打开，数字、标签、单位与原始输入一致。
- 执行随包verify.py检查真实文件；参考材料不能冒充自己的模型运行。
- 已运行Marp CLI 4.5.1，实际生成HTML/PDF与页面截图；源稿人工编写，未执行AI模型。
常见问题
下载素材后能直接看到AI生成结果吗？
已运行Marp CLI 4.5.1，实际生成HTML/PDF与页面截图；源稿人工编写，未执行AI模型。
Marp Markdown培训课件要怎样判断完成？
按本页步骤执行自己的工具环境，核对原始输入、实际产物与检查清单；下载成功、程序启动或参考文件存在都不能代替实际结果验收。