最可靠导出html方式是jupyter nbconvert命令行：默认导出依赖cdn导致离线公式不显示，需用--html-mathjax-url指定本地mathjax路径；中文路径易报错，应改用英文路径或--output指定英文输出名；voilà不适用于静态交付场景。
用 jupyter nbconvert 命令行导出 HTML 最可靠
GUI 点菜单导出（File → Download as → HTML）看似方便，但经常卡住、漏样式、不渲染 MathJax，尤其含复杂图表或自定义 CSS 时。命令行才是稳定出口。
实操建议：
- 在终端进入 notebook 所在目录，运行：
jupyter nbconvert --to html notebook.ipynb
- 加
--no-input可隐藏代码单元，只留输出和 Markdown：jupyter nbconvert --to html --no-input notebook.ipynb
- 若需完整环境兼容（比如离线打开），加
--embed-images和--execute（先运行再导出）：jupyter nbconvert --to html --execute --embed-images notebook.ipynb
- 注意：默认导出的 HTML 依赖 CDN 加载 MathJax 和 highlight.js，内网或断网打不开公式——得加
--html-mathjax-url或改配置
导出 HTML 后公式不显示？检查 MathJax 加载方式
常见错误现象：HTML 文件里 $$E=mc^2$$ 渲染成纯文本，右键无 MathJax 上下文菜单。
原因很直接：nbconvert 默认用 CDN 加载 MathJax，但有些网络拦截、或本地双击打开（file:// 协议）会因 CORS 拒绝加载。
立即学习“前端免费学习笔记（深入）”；
解决办法：
- 用
--html-mathjax-url指向本地拷贝的 MathJax（推荐）：jupyter nbconvert --to html --html-mathjax-url="./mathjax/tex-chtml.js" notebook.ipynb
- 或者改 Jupyter 配置，让所有导出默认用本地路径（全局生效）：
jupyter nbconvert --generate-config
，然后编辑~/.jupyter/jupyter_nbconvert_config.py，加一行：c.HTMLExporter.mathjax_url = './mathjax/tex-chtml.js'
- 别用
--no-mathjax，那等于主动放弃公式支持
用 voilà 替代 HTML 导出？小心适用场景错配
有人听说 voilà 能“把 notebook 变成网页”，就拿来当 HTML 导出替代方案——这是典型误用。
voilà 是服务端实时渲染，启动一个本地 HTTP 服务（voilà notebook.ipynb），生成的是可交互界面，不是静态文件。它不能直接发给同事当报告附件，也不适合存档或邮件发送。
真正需要静态 HTML 的场景（如提交作业、嵌入文档、离线汇报），必须用 nbconvert；只有想做轻量仪表盘、且接收方能跑 Python + voilà 时，才考虑它。
-
voilà输出页面里所有交互控件（ipywidgets）都有效，但 HTML 导出里它们全失效 -
voilà不生成单个 .html 文件，而是一整套临时服务目录，没法直接双击打开 - 导出 HTML 体积小（几十 KB～几 MB），
voilà页面依赖整个内核通信链路，离线即瘫痪
中文路径/文件名导致导出失败？绕过编码陷阱
Windows 或旧版 macOS 下，notebook 文件名含中文，nbconvert 常报错：
OSError: [Errno 22] Invalid argument: '测试_分析.ipynb'，或导出 HTML 乱码、缺资源。
这不是 bug，是 Python 3.6+ 在 Windows 上对非 ASCII 路径处理仍不统一所致。
最省事的解法：
- 把 notebook 移到纯英文路径下操作，比如
C:\tmp\note.ipynb - 终端也切到该路径再执行
nbconvert，别用带空格或中文的父目录 - 实在要保留中文名，可用
--output强制指定英文输出名：jupyter nbconvert --to html --output report.html "数据_分析.ipynb"
- 别指望升级 Jupyter 就解决——底层是系统 API 限制，跨平台一致性至今没彻底修复
