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

作者已运行 · 输出为 HTML

本篇交付浏览器可打开的 HTML 演示稿，不是 PPTX，也不依赖来源不明的 PPT Skill。作者实现并运行了固定样例转换脚本，尚无独立读者复现。

1. 场景价值与交付产物预览

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

打开完整演示稿

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

2. 前置准备与环境配置

作者运行环境：macOS 26.5.1 arm64、Node.js 26.8.1、当前 Codex 会话；使用 Ego 浏览器检查产物。未验证其他系统组合，安装和操作耗时均未测量。

在空目录保存 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. Prompt 与执行过程

先运行现成样例确认环境，再让 Codex 帮你修改提纲或样式。以下是供读者使用的整理版 Prompt，不是作者原始对话记录：

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

作者在本次整改会话中编写提纲和脚本，实际生成文件；随后在两个新目录分别重新生成，产物字节相同。浏览器逐页截图检查四页标题和列表，桌面与 390px 移动视口没有检测到横向溢出。

逐页截图过程中首次使用的链接定位器未匹配，重新观察页面后改用实际元素选择器，才完成截图。这是工具操作修正，没有修改生成结果来掩盖失败。

5. 排障与验收要求

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

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

6. 示例源码与产物资源

• 原始提纲与转换脚本。
• 下载 HTML 演示稿，或直接预览。
• 实际预览截图与验证摘要。
• 内容标准与反馈格式：独立读者记录仍为 0。