本文介绍一种通用、可靠的方法，将 Jupyter Notebook 中 display() 函数实际呈现的内容（HTML/SVG/图片等）完整导出为静态 HTML 文件，无需依赖第三方库或对象特化逻辑，真正实现“所见即所得”（WYSIWYG）式保存。
本文介绍一种通用、可靠的方法，将 jupyter notebook 中 `display()` 函数实际呈现的内容（html/svg/图片等）完整导出为静态 html 文件，无需依赖第三方库或对象特化逻辑，真正实现“所见即所得”（wysiwyg）式保存。
Jupyter 的 display() 函数是交互式数据分析的强大工具——它能智能渲染 DataFrame、Matplotlib 图表、Plotly 可视化、LaTeX 公式、自定义 HTML 片段甚至嵌入式视频。其底层会根据对象类型生成对应 MIME 类型（如 text/html、image/svg+xml、application/vnd.jupyter.widget-view+json），并由前端内核统一渲染。正因如此，直接捕获 display() 的输出并非调用某个单一方法就能完成；它本质上是前端渲染结果的快照，而非 Python 对象的序列化。
幸运的是，Jupyter 提供了成熟、稳定且原生支持的解决方案：nbconvert。它不是“模拟”渲染（如手动调用 df.to_html() 或 fig.savefig()），而是复用 Jupyter 内核与前端的完整渲染链路，将 notebook 执行后的最终输出（包括所有 display() 生成的富媒体）完整转换为静态 HTML。
✅ 推荐方案：使用 nbconvert 导出带渲染输出的 HTML
在终端中执行以下命令（Linux/macOS）：
jupyter nbconvert \ --to html \ --no-input \ --TagRemovePreprocessor.enabled=True \ --TagRemovePreprocessor.remove_cell_tags="['skip-export']" \ your_notebook.ipynb
该命令含义如下：
- --to html：目标格式为 HTML（保留所有富媒体渲染）；
- --no-input：隐藏代码单元格，仅保留输出（符合“保存 display 结果”的核心诉求）；
- --TagRemovePreprocessor：通过单元格标签精细控制导出范围（可选但强烈推荐）。
? 使用技巧：精准控制哪些 display() 输出被保存
- 在 Jupyter 中，选中你希望导出的代码单元格 → 点击菜单栏 View → Cell Toolbar → Tags；
- 在单元格右上角输入标签，例如 export-me；
- 修改 nbconvert 命令，只保留带该标签的单元格输出：
jupyter nbconvert \ --to html \ --no-input \ --TagRemovePreprocessor.enabled=True \ --TagRemovePreprocessor.remove_cell_tags="['skip-export']" \ --CellTagRemovePreprocessor.remove_cell_tags="['skip-export']" \ your_notebook.ipynb
? 注意：TagRemovePreprocessor 移除的是整个单元格（含输入和输出），而 CellTagRemovePreprocessor（需 jupyter-nbconvert ≥ 7.0）更精细，可单独移除不匹配标签的单元格。若版本较旧，建议统一用 TagRemovePreprocessor 并为“不导出”的单元格打 skip-export 标签。
? 输出效果与优势
生成的 .html 文件可在任意现代浏览器中打开，完全保留：
- DataFrame 的交互式表格样式（含排序、滚动）；
- SVG 图表的矢量缩放能力；
- MathJax 渲染的 LaTeX 公式；
- Plotly 的交互控件（缩放、悬停、下载）；
- 自定义 HTML/CSS/JS 组件（只要 notebook 执行时已加载）。
这比手动调用 pandas.DataFrame.to_html()、matplotlib.figure.savefig() 或第三方库（如 df_to_svg）更一致、更健壮——因为它是真实运行时渲染的镜像，而非对数据对象的近似转换。
⚠️ 注意事项
- 确保 notebook 已完整执行（Run All），否则未运行单元格的 display() 输出不会出现在 HTML 中；
- 外部资源（如本地图片路径、远程 JS/CSS）需确保相对路径正确或已内联（nbconvert 默认不打包外部资源）；
- 若含复杂前端组件（如自定义 ipywidgets），需确认目标环境已加载对应 JavaScript 包（可添加 --embed-images 或配合 --template 自定义模板增强兼容性）；
- Windows 用户请将命令中的反斜杠 \ 替换为 ^ 或写在单行中，或使用 PowerShell 的反引号 ` 作为续行符。
总之，jupyter nbconvert --to html 是目前最贴近“保存 display() 所见”的官方、通用、可复现方案——它不猜测、不模拟、不降级，而是忠实地将 Jupyter 的渲染成果固化为跨平台静态文档。
