Markdown 变成 HTML 演示稿：生成后逐页检查

本课把一份简短提纲生成可在浏览器打开的演示稿，并逐页检查。需要 Node.js；输出为 HTML，不是 PowerPoint 的 PPTX。如果你需要可编辑的 PPTX 文件，这篇不适用。

1. 先看生成的演示稿

适合已有简短 Markdown 提纲，希望做成可分享页面的读者。输入为本站原创教学提纲，输出是封面加三个章节，共 4 页。

打开完整演示稿

示例没有客户数据、市场数字或效率提升指标。格式约束很窄，不是通用 Markdown 渲染器。

2. 下载提纲和转换脚本

准备 Node.js 和能打开本地 HTML 文件的浏览器。生成步骤不需要 Codex；后续可让 Codex 帮忙调整内容，并由你检查结果。

在 Finder 新建 codex-slides-practice 文件夹。在系统终端输入 cd ，把文件夹拖入终端后回车，执行 pwd 确认位置。

在这个目录保存 outline.md 和 render.mjs。这个脚本由本站编写，可复制、修改和运行用于学习；先查看源码再执行。

node --version
node render.mjs outline.md slides.html

预期显示 Generated 4 HTML slides: slides.html。用浏览器打开生成的 slides.html，无需安装第三方依赖。

3. 按脚本支持的格式准备提纲

不需要额外配置。脚本只识别一个一级标题、三个二级标题和每章三个列表项，其余说明段落不进入正文页。改变结构时会报错，而不是静默丢掉某一章节。

输出 HTML 通过脚本生成，本站构建时也从同一源码生成，避免手工维护两份内容。没有 PPTX 导出能力。

4. 让 Codex 生成并检查演示稿

先运行现成样例确认环境，再在 Codex 中打开该目录，发送以下任务：

请读取 outline.md 和 render.mjs，说明这个转换器支持的输入范围。
运行 node render.mjs outline.md slides.html，生成 HTML 演示稿。
如果有浏览器工具，打开产物逐页检查；否则明确请我人工检查。
核对四页内容是否与提纲一致，检查文字溢出和导航。
不得添加提纲中没有的业务数据，不要把 HTML 改名为 PPTX。
报告实际结果、人工介入和未验证项。

再让 Codex 做一次真正的内容改写

先复制原始提纲保存为 outline.original.md，然后发送：

把 outline.md 改成面向第一次使用 AI 编程工具的同事的分享稿。
保留一个一级标题、三个二级标题和每章三个列表项。
只改写表达，不新增业务数据，不修改 render.mjs。
另生成 slides-beginner.html，保留原 slides.html 供对照。
列出哪几句话改了，为什么更适合这个读者。

重新运行 node render.mjs outline.md slides-beginner.html，打开新旧两个文件对比。检查的重点是九条要点是否仍然忠于原意、是否更容易理解，而不是只看文件有没有生成。若它把结构改成五章，先要求恢复输入约定，再渲染。

把提纲和第二页放在一起看

原始提纲中，这一章是：

## 先定义结果
- 输入：明确的任务与样例。
- 输出：可以打开和检查的文件。
- 边界：未测试的环境明确说明。

下面是实际 HTML 中对应的第二页。标题和三条内容一一对应；封面看起来正常，不代表后面没有漏字。

打开成品后点顶部“第 2 页”，应跳到这一章；再点“第 4 页”，检查结尾。如果正文比截图更长，缩窄窗口再看换行，别只检查大屏。

5. 逐页检查内容与排版

• 页数和结构报错：检查是否仍为一个一级标题、三个二级标题、每章三个列表项。本样例不支持表格、图片和任意 Markdown。
• 文件生成但不能读：确认以 UTF-8 保存源文件，打开实际 .html 文件。
• 需要 PPTX：本案例不满足；应选择有已验证 PPTX 导出的工具，不能改扩展名冒充。
• 加入长文本后溢出：重新逐页检查；当前通过的是固定提纲，不保证任何输入都能排版合格。

验收包括：文件能打开，四页标题和九条正文列表与输入一致，没有新增业务数值，逐页可读，导航能定位相应章节。打印到 PDF、办公软件导入与专业设计品质不在本次验收范围内。

6. 下载源码与演示稿

• 原始提纲与转换脚本。
• 下载 HTML 演示稿，或直接预览。
• 实际预览截图。
• 内容标准与反馈格式。