Jupyter Notebook导出HTML+ToC异常：编号目录丢失，导出结果无差异

原因分析 #

• Notebook界面编号是动态渲染的：你在Notebook里看到的1.2、2.2.3这类层级编号，是Jupyter前端UI实时生成的视觉效果，并没有写入Markdown源文件中——你的标题单元格里实际只有#、##这类层级标记，没有硬编码的编号。内置导出工具（nbconvert）只会解析Markdown源内容，不会识别UI渲染出来的编号。
• HTML+ToC选项的功能局限：这个选项仅为导出的HTML添加可跳转的目录导航，不会为标题自动生成或保留界面显示的层级编号，它和普通HTML导出的核心差异仅在于目录组件，而非标题编号的保留。

解决办法 #

• 手动给Markdown标题添加编号：直接在Notebook的Markdown单元格中，为标题硬编码层级编号，比如将## 数据预处理改为## 1.2 数据预处理，导出HTML时编号会被直接保留。
• 自定义nbconvert配置实现自动编号：
  1. 生成默认配置文件：jupyter nbconvert --generate-config
  2. 打开配置文件（路径通常为~/.jupyter/jupyter_nbconvert_config.py），修改HTMLExporter相关设置，添加自定义模板或修改现有模板的CSS规则，通过CSS计数器实现标题自动编号。例如，在模板的样式中添加：

     body {counter-reset: h1}
     h1 {counter-reset: h2}
     h2 {counter-reset: h3}
     h1:before {counter-increment: h1; content: counter(h1) ". "}
     h2:before {counter-increment: h2; content: counter(h1) "." counter(h2) ". "}
     h3:before {counter-increment: h3; content: counter(h1) "." counter(h2) "." counter(h3) ". "}
     

  3. 导出时指定自定义配置：jupyter nbconvert --to html --config jupyter_nbconvert_config.py your_notebook.ipynb
• 使用第三方导出工具：部分Jupyter Lab扩展或第三方nbconvert模板，支持导出时自动保留标题层级编号，可以直接安装使用。

内容的提问来源于stack exchange，提问作者Catherine