JupyterLab中含HTML格式的Pandas DataFrame导出PDF时表格无法正常显示的问题解决咨询

这个问题我之前也碰到过——本质是Jupyter的PDF导出工具（默认用nbconvert+LaTeX）无法直接解析IPython.core.display.HTML对象，只会输出它的字符串表示。下面给你几个靠谱的解决方案，按需选择：

方案一：用LaTeX表格替代HTML（适合学术风格PDF场景） #

如果你的主要需求是导出规范表格，不需要太复杂的HTML样式，可以直接让Pandas生成LaTeX代码，nbconvert能完美渲染：

import pandas as pd
from IPython.display import Latex

# 假设你的DataFrame是df，可自定义表格格式
latex_table = df.to_latex(
    index=False,
    column_format='|l|c|r|',  # 左对齐、居中、右对齐列，带竖线
    caption='自定义表格标题',
    label='tab:my_table'
)

# 显示LaTeX表格，导出PDF时会自动渲染
display(Latex(latex_table))

要是需要复杂样式（比如背景色、合并单元格），可以手动调整LaTeX代码，或者用booktabs这类LaTeX包美化表格。

方案二：用Web PDF导出（完美保留HTML样式） #

如果你的表格有复杂HTML样式（比如颜色、自定义边框），强烈推荐JupyterLab的Web PDF导出功能，它会先渲染页面（和浏览器显示效果一致）再转PDF：

1. 在JupyterLab打开Notebook
2. 点击顶部菜单栏File → Export Notebook As → Export Notebook to Web PDF
3. 等待渲染完成后下载PDF即可

习惯命令行的话，也可以运行：

jupyter nbconvert --to webpdf your_notebook.ipynb

注意：该方法依赖浏览器WebKit引擎，无桌面环境的服务器可能需要额外配置puppeteer或Chrome headless。

方案三：把HTML嵌入Markdown单元格（灵活控制样式） #

另一种思路是把生成的HTML表格直接放到Markdown单元格，而非代码输出：

1. 先运行代码生成HTML字符串：

html_table = df.to_html(classes='custom-table', index=False)
print(html_table)

2. 复制输出的HTML字符串，新建Markdown单元格粘贴进去
3. （可选）添加自定义CSS控制样式，比如在代码单元格运行：

from IPython.display import HTML

display(HTML("""
<style>
.custom-table {
    border-collapse: collapse;
    width: 100%;
}
.custom-table th, .custom-table td {
    border: 1px solid #ddd;
    padding: 8px;
    text-align: left;
}
.custom-table th {
    background-color: #f2f2f2;
}
</style>
"""))

导出Web PDF时会完整保留所有设置的样式。

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