Jupyter Notebook 直接导出为 Slides 幻灯片，关键步骤其实很明确：先在 Notebook 里给每个 cell 设好 Slide 类型，比如 Slide、Sub-Slide 这些，再执行 jupyter nbconvert --to slides notebook.ipynb。

这里有两个点不能忽略：一是 notebook 必须先保存，否则这些元数据不会真正持久化；二是需要通过 --reveal-prefix 指定 reveal.js 的路径，通常推荐用 CDN。

导出完成后，最好再用本地服务器打开生成的 HTML，比如 python -m http.server。因为直接用 file:// 协议打开，JS 很容易失效。

直接导出为 Slides 幻灯片，核心就两步：先在 Notebook 里标记 cell 类型，再用 jupyter nbconvert 命令生成 HTML。

不装额外插件也能跑，但漏掉 cell 类型设置或路径配置错误，生成的 HTML 就不是幻灯片，而是普通网页。

怎么给 cell 设置 Slide 类型（必须做）

这是整个流程的前提。没设类型，nbconvert --to slides 会把所有 cell 当成普通内容堆在一起，不会分页。

• 在 Jupyter Notebook 界面顶部菜单栏点击 View → Cell Toolbar → Slideshow，右上角会出现 Slide Type 下拉框
• 每个 cell 都要手动选一个类型：Slide（主页）、Sub-Slide（上下翻页的子页）、Fragment（按空格逐步显示）、Skip（不导出）、Notes（仅演讲者备注）
• 改完必须 保存 notebook（Ctrl+S 或 File → Sa ve and Checkpoint），否则 nbconvert 读不到这些元数据

jupyter nbconvert --to slides 的实际用法和常见报错

这条命令本身不依赖 jupyter2slides 或 RISE，是 nbconvert 内置的 SlidesExporter。

但默认用的是老版本 reveal.js，容易报 Reveal is not defined。

• 基础命令：jupyter nbconvert --to slides your_notebook.ipynb，会在同目录生成 your_notebook.slides.html
• 如果报 Reveal is not defined，说明 HTML 里没加载 reveal.js。解决方法：加 --reveal-prefix 指向本地或 CDN 路径，例如：--reveal-prefix "https://unpkg.com/reveal.js@4.4.0"
• 若想用自定义主题或样式，不要硬改 HTML，而是通过 --template 指向 jinja2 模板文件，比如：--template /path/to/my_reveal.tpl
• 注意：命令运行时当前工作目录必须能访问到 notebook 文件，相对路径别写错；.ipynb 后缀不能省

为什么生成的 HTML 打不开或样式错乱

本质是静态资源路径问题。nbconvert 生成的 HTML 默认假设 reveal.js 在本地 reveal.js-3.1.0/ 目录下，但新版 reveal.js 结构变了，CDN 地址也不同。

• 最简方案：用 CDN 替代本地路径，命令里加 --reveal-prefix "https://unpkg.com/reveal.js@4.4.0"（版本号建议锁定）
• 如果离线使用，得提前下载 reveal.js 到项目目录，比如 ./reveal.js/，然后用 --reveal-prefix "reveal.js"
• 生成的 HTML 文件双击打开会因浏览器安全策略禁用 JS（file:// 协议），必须用 HTTP 服务启动：python -m http.server 8000，然后访问 http://localhost:8000/your_notebook.slides.html
• 别用 --to html 再手动改——它不带 slide 分页逻辑，跟 --to slides 生成的结构完全不同

导出前重点确认的 3 件事

真正卡住人的，往往不是命令敲错，而是细节没处理好。

• cell 类型已经设置，并且 notebook 已保存
• 命令里带上了 --reveal-prefix
• 生成的 HTML 必须通过本地服务器打开

如果这三件事都确认到位，导出 Slides 幻灯片通常就不会出大问题。常见白屏、样式错乱，往往都是 cell 类型没有保存、reveal.js 路径配错，或者直接双击 HTML 打开导致的。

《夸克》非常好用的免费AI浏览器

下载APP查看