Jupyter Notebook目录内部超链接简便实现方法及相关问题咨询

1 解决replace方法返回带单引号的问题 #

直接执行字符串替换操作得到的是Python字符串对象，单元格默认输出的是其repr()展示形式，因此会自带单引号。只要用print()函数输出结果即可得到无额外符号的可用代码：
示例代码：

section_name = "Section 1"
link = f'<a href="#{section_name.replace(" ", "-")}">{section_name}</a>'
print(link)

运行后直接复制打印输出的内容，即可粘贴到Markdown单元格使用。

2 更简便的原生Markdown链接语法 #

不需要手动编写HTML的a标签，Jupyter原生支持标准Markdown内部锚点语法，格式为：
[链接显示文本](#替换空格为短横线的标题)
比如对应# Section 1的标题，直接写[Section 1](#Section-1)即可实现跳转，和a标签效果完全一致，编写成本更低。

3 批量生成目录的工具函数 #

如果需要生成多章节的目录，可以写一个简单的Python函数批量输出可用的目录项：

def generate_toc(title_list):
    toc_items = []
    for title in title_list:
        href = title.replace(" ", "-")
        toc_items.append(f"- [{title}](#{href})")
    # 直接打印可直接复制的Markdown格式目录
    print("\n".join(toc_items))

# 调用示例，填入你的所有章节标题即可
generate_toc([
    "Section 1 基础介绍",
    "Section 2 环境配置",
    "Section 3 代码实现",
    "Section 4 结果分析"
])

运行后输出的内容直接复制到Markdown单元格就是完整的可跳转目录。

4 免手动编写的自动目录方案 #

你可以安装jupyter_contrib_nbextensions扩展包，启用其中的Table of Contents (2)插件，安装命令为pip install jupyter_contrib_nbextensions && jupyter contrib nbextension install，安装完成后重启Jupyter，在Nbextensions标签页勾选对应插件即可生效。启用后会自动生成整个笔记本的悬浮/置顶目录，完全不需要手动编写任何链接，点击目录项即可自动跳转对应章节。

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