如何将Jupyter Notebook拆分为多张幻灯片？解决RISE/nbconvert单张生成问题

嘿，这个坑我之前踩过！其实不管是RISE还是nbconvert，都不会自动按标题拆分幻灯片——它们完全依赖单元格的幻灯片元数据来决定页面划分。下面给你分步讲怎么配置，轻松拆分出多张幻灯片：

一、可视化设置单元格类型（推荐，适合RISE实时预览） #

1. 打开你的Jupyter Notebook，点击顶部菜单栏的「视图」→「单元格工具栏」→「幻灯片浏览」（View → Cell Toolbar → Slideshow）。
2. 此时每个单元格顶部会出现一个下拉菜单，你可以给每个单元格指定对应的幻灯片角色：
   • Slide：生成一张全新的独立幻灯片，是页面的起始点。
   • Sub-slide：属于当前Slide的子页面，按右箭头键切换。
   • Fragment：当前幻灯片内的隐藏内容，按空格键逐步展示（适合分步讲解内容）。
   • Skip：该单元格不会出现在幻灯片中（适合草稿或注释）。
   • Notes：演讲者专属备注，只有在演讲者视图里能看到。
3. 举个实用配置：把一级标题单元格设为Slide，二级标题设为Sub-slide，正文内容设为Fragment，这样就能自动拆分出层级清晰的多张幻灯片啦。

二、命令行nbconvert生成幻灯片的注意事项 #

如果你用nbconvert命令生成幻灯片，确保已经按上面的步骤设置好所有单元格的元数据，然后执行以下命令：

jupyter nbconvert your_notebook.ipynb --to slides --post serve

生成的网页幻灯片会严格按照你设置的元数据拆分页面，不会再出现单张超长幻灯片的情况。

常见排查点 #

如果还是没拆分成功，检查这两点：

• 是不是不小心把所有单元格都设成了Slide或者同一个类型？
• 有没有开启「幻灯片浏览」工具栏，确认每个单元格的设置都正确？

内容的提问来源于stack exchange，提问作者P-Gn