# Marp Markdown培训课件

已运行Marp CLI 4.5.1，实际生成HTML/PDF与页面截图；源稿人工编写，未执行AI模型。

1. 核对五页教学目标
阅读course-outline.md，明确最后一页答案是登记缺件。AI可以协助压缩文字，但素材内的人工slides.md是可独立复现的源文件。
python3 verify.py

2. 安装固定Marp CLI
在marp-project目录安装@marp-team/marp-cli 4.5.1。工程只写练习目录，避免更改业务项目依赖；HTML导出先验证命令可用。
cd marp-project
npm install
npm run html

3. 识别全局主题与分隔符
打开slides.md，检查marp:true、theme和paginate。用---分隔五页，每页保留短标题与两三条要点，不用一页塞完整提纲。


4. 查看真实HTML演示
打开生成的training.html，逐页前进检查页码、中文与最后练习。文字超框时先减信息量或拆分，不能只缩到难读。


5. 加入仅讲者可见的备注
把讲解提醒放到Marp支持的注释备注中。观众正文只留操作要点；查看导出的讲稿，检查备注跟随正确页码。
npx marp slides.md --notes -o notes.txt

6. 生成PDF并打开
安装可用浏览器后用同一源文件导出PDF，打开检查五页。若Chrome路径自动识别失败，按CLI浏览器参数配置自己的浏览器。
npm run pdf

7. 保存源文件与真实产物
一起保留slides.md、主题CSS、HTML/PDF和notes.txt。文件由Marp实际渲染，内容为人工教学源稿，不称作AI生成成果。


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