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

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

1. 先看生成的演示稿

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

打开完整演示稿

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

2. 下载提纲和转换脚本

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

在空目录保存 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。
报告实际结果、人工介入和未验证项。

练完固定样例后，可以在副本里只替换一条列表文字，保持标题和列表数量不变，再次生成。检查输出是否只出现预期的文字变化。这样才能区分“会运行脚本”和“知道怎样安全调整输入”。

5. 逐页检查内容与排版

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

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

6. 下载源码与演示稿

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