基于标签生成多版本Jupyter Notebook遇nbconvert转档问题求助

问题原因 #

你遇到的情况是因为--to notebook默认使用的NotebookExporter没有自动启用TagRemovePreprocessor，而HTML导出器默认包含了这个预处理器，所以之前的命令在转HTML时生效，转Notebook时不生效。

直接命令行解决方案 #

要让标签移除在转Notebook时生效，需要明确指定导出器并启用预处理器，执行以下命令：

jupyter nbconvert nbconvert-example.ipynb --to notebook --exporter notebook --TagRemovePreprocessor.remove_cell_tags='{"remove_cell"}' --output student-version

• --exporter notebook：强制使用Notebook导出器并加载预处理器配置
• --output student-version：指定输出的笔记本文件名，避免覆盖原文件

如果需要移除单元格的输出（而非整个单元格），可以添加输出标签的配置：

jupyter nbconvert nbconvert-example.ipynb --to notebook --exporter notebook --TagRemovePreprocessor.remove_output_tags='{"remove_output"}' --output student-version

批量自动化方案（适合大项目） #

如果需要处理大量笔记本，写Python脚本更高效，还能自定义多版本规则（比如同时生成学生版和教师版）。示例脚本如下：

from nbconvert import NotebookExporter
from nbconvert.preprocessors import TagRemovePreprocessor
from traitlets.config import Config
import nbformat
import os

def generate_notebook_version(input_path, output_path, remove_cell_tags=None, remove_output_tags=None):
    # 加载原始笔记本
    with open(input_path, "r", encoding="utf-8") as f:
        nb = nbformat.read(f, as_version=4)

    # 配置预处理器
    c = Config()
    if remove_cell_tags:
        c.TagRemovePreprocessor.remove_cell_tags = set(remove_cell_tags)
    if remove_output_tags:
        c.TagRemovePreprocessor.remove_output_tags = set(remove_output_tags)
    c.NotebookExporter.preprocessors = [TagRemovePreprocessor]

    # 导出处理后的笔记本
    exporter = NotebookExporter(config=c)
    output, _ = exporter.from_notebook_node(nb)

    # 保存版本
    with open(output_path, "w", encoding="utf-8") as f:
        f.write(output)

# 示例：生成学生版（移除教师专属内容和要删除的单元格）
generate_notebook_version(
    "nbconvert-example.ipynb",
    "student-version.ipynb",
    remove_cell_tags=["teacher_only", "remove_cell"],
    remove_output_tags=["hide_output"]
)

# 示例：生成教师版（移除学生专属提示单元格）
generate_notebook_version(
    "nbconvert-example.ipynb",
    "teacher-version.ipynb",
    remove_cell_tags=["student_only"]
)

注意事项 #

• 确保单元格标签正确添加：在Jupyter中打开View > Cell Toolbar > Tags，给目标单元格添加对应标签（如teacher_only、remove_cell）
• 标签集合支持多个标签，命令行中用{"tag1", "tag2"}格式，Python脚本中用列表传递
• 批量处理时，可以遍历文件夹中的所有.ipynb文件，循环调用上述函数

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