Nbconvert webpdf模式运行Python脚本时生成多余PDF页面问题咨询

异常分页的原因 #

• %run <myscript.py>执行后，Jupyter会将脚本的print输出作为独立的输出单元格处理。Nbconvert的webpdf引擎（基于Chrome无头模式）对不同类型单元格有默认排版规则，输出单元格可能被添加了强制分页样式，或单元格间margin/padding过大，导致第一页MarkDown1后的空白空间不足以容纳输出单元格（含边距），从而被推到下一页。
• 若脚本中多个print语句被拆分为多个输出块，每个块都会触发独立的分页判断，进一步加剧分页问题。

webpdf的分页判定依据 #

Nbconvert的--to webpdf本质是通过Chrome无头模式渲染notebook的HTML版本，再调用打印功能生成PDF，分页逻辑完全遵循Chrome打印规则：

• 内容高度限制：当当前页面剩余高度无法容纳整个单元格（含上下边距、内边距）时触发分页。即使内容仅几行，若单元格容器设置了page-break-after: always或page-break-inside: avoid，会强制分页。
• CSS样式影响：Nbconvert生成的HTML自带默认CSS，针对代码输出单元格可能设置了避免内部分页、增大单元格间距的规则，容易导致输出单元格无法放入前一页剩余空间。
• 元素类型差异：Markdown、代码、输出单元格的容器标签和样式不同，输出单元格的block布局加上固定间距，更易触发分页。

解决办法 #

• 自定义CSS覆盖默认样式：创建custom.css文件，调整单元格分页和间距：

  /* 移除输出单元格的强制分页规则 */
  .output_area {
    page-break-after: auto !important;
    page-break-inside: auto !important;
    margin: 1em 0 !important;
  }
  /* 缩小Markdown单元格底部间距 */
  .markdown_cell {
    margin-bottom: 0.5em !important;
  }
  

  执行Nbconvert时指定该CSS：

  jupyter nbconvert --to webpdf --css custom.css your_notebook.ipynb
  

• 合并输出块：将脚本中多个print语句合并为一次输出（比如用字符串拼接所有内容后统一print），减少输出单元数量，降低分页触发概率。
• 调整Chrome打印参数：通过--WebPDFExporter.chrome_args修改页面边距等打印设置：

  jupyter nbconvert --to webpdf --WebPDFExporter.chrome_args="--print-to-pdf=margin-top=0.5in,margin-bottom=0.5in,margin-left=0.5in,margin-right=0.5in" your_notebook.ipynb
  

内容的提问来源于stack exchange，提问作者Andrea A.