Jupyter Notebook深色模式导出HTML后输出内容不可读问题求助

方案1：用自定义CSS强制指定输出文本颜色 #

之前修改custom.css无效是因为这个文件只作用于Jupyter Notebook的交互界面，不影响nbconvert的导出样式。你可以创建一个专门用于导出的CSS文件，比如命名为export_fix.css，内容如下：

/* 修复代码输出块的文本与背景融合问题 */
div.output_area pre {
    color: #f0f0f0 !important; /* 浅灰色文本，适配深色背景 */
    background-color: #252525 !important; /* 固定深色背景，可选 */
}
/* 修复普通文本输出的可读性 */
div.output_area p {
    color: #f0f0f0 !important;
}

然后执行导出命令时指定这个CSS文件：

jupyter nbconvert <你的笔记本文件名>.ipynb --to html --CSSHTMLHeaderPreprocessor.style=./export_fix.css

方案2：自定义nbconvert模板 #

如果方案1效果不好，可以直接修改导出用的HTML模板：

1. 创建一个名为custom_export.tpl的模板文件，内容如下：

{% extends 'full.tpl' %}

{% block style %}
{{ super() }}
<style>
/* 针对所有输出区域的文本设置 */
div.output_area pre,
div.output_area p,
div.output_area .MathJax {
    color: #ffffff !important;
}
/* 可选：固定输出区域背景色 */
div.output_area {
    background-color: #1e1e1e !important;
}
</style>
{% endblock %}

2. 用这个模板执行导出：

jupyter nbconvert <你的笔记本文件名>.ipynb --to html --template=./custom_export.tpl

方案3：修复深色主题导出命令的报错 #

你之前用--HTMLExporter.theme=dark报错，大概率是nbconvert版本过低，先升级到最新版：

pip install --upgrade nbconvert

升级后再尝试以下命令（不同版本参数可能有差异，两种都试试）：

# 方式1：指定theme参数
jupyter nbconvert <你的笔记本文件名>.ipynb --to html --HTMLExporter.theme=dark
# 方式2：直接指定深色模板
jupyter nbconvert <你的笔记本文件名>.ipynb --to html --template=dark

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