命令行jupyter nbconvert导出html更可靠，因其纯后端渲染不依赖浏览器，而gui导出易卡顿、漏样式、公式不渲染；必须加--execute、--embed-images等参数确保图表、公式、离线功能完整。
用 jupyter nbconvert 命令行导出 HTML 才真正可靠，GUI 点菜单（File → Download as → HTML）经常卡住、漏样式、公式不渲染，尤其含 Plotly 图表或自定义 CSS 时基本不可用。
为什么命令行比菜单导出更稳
菜单导出本质是前端触发的 JS 渲染流程，依赖浏览器环境和内核响应；而 jupyter nbconvert 是纯后端解析 + 模板渲染，只要 .ipynb 文件能读，就能出 HTML，不卡、不丢输出、不崩 MathJax。
- GUI 导出常报“空白页”或“Loading…”不动——其实是前端没拿到内核返回的单元格输出
- 菜单导出默认不执行代码，图表、
print()、变量值全为空白 - 它硬编码用了 Lab 主题模板，离线打开时 CSS 和 JS 路径全 404
jupyter nbconvert --to html 必加的参数
基础命令 jupyter nbconvert --to html notebook.ipynb 只转结构，不跑代码、不嵌图、不加载本地 MathJax——得靠这几个参数补全：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
-
--execute：必须加，否则所有图表、plt.show()、display()全消失 -
--embed-images：把 PNG/SVG 图片 Base64 编码进 HTML，避免相对路径失效 -
--no-input：隐藏代码块，只留 Markdown 和输出，适合汇报场景 -
--output-dir /abs/path/to/out：用绝对路径，别用./out，工作目录错位会导致生成失败
公式不显示？八成是 MathJax 加载失败
现象：$$E=mc^2$$ 渲染成纯文本，右键无 MathJax 菜单；原因：默认从 CDN（如 https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js）加载，但 file:// 协议或内网环境会因 CORS 被拦截。
- 最简解法：加
--html-mathjax-url "./mathjax/tex-chtml.js"，前提是本地有 MathJax 文件（可从官网下载或pip install mathjax后找路径） - 全局生效：运行
jupyter nbconvert --generate-config，编辑~/.jupyter/jupyter_nbconvert_config.py，加一行c.HTMLExporter.mathjax_url = './mathjax/tex-chtml.js' - 别用
--no-mathjax：这直接禁用公式支持，不是“解决”，是放弃
Plotly/Bokeh 图表打不开？离线加载链断了
这些库默认生成外部 JS 脚本引用（比如 https://cdn.plot.ly/plotly-2.29.0.min.js），双击 HTML 或内网打开时请求被拒，图表区域空白。
- 必须配
--embed-images+--execute，让 nbconvert 把 JS 内联或打包进 HTML - Plotly 额外需在 notebook 里提前运行：
import plotly.offline; plotly.offline.init_notebook_mode(connected=True) - Bokeh 推荐用
output_file()+save()生成独立 HTML，再合并——nbconvert 对 Bokeh 支持弱 - 别手动改生成的 HTML：JS 路径、data URLs、MathJax 初始化顺序都耦合紧密，一动就挂
真正麻烦的不是命令怎么写，而是每个参数背后都对应一个加载链路：代码执行、图片嵌入、JS 注入、MathJax 初始化——漏一个，HTML 就残一个功能。建议先跑通 jupyter nbconvert --to html --execute --embed-images --no-input notebook.ipynb，再按需加 MathJax 或模板定制。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
