Jupyter Notebook内部链接异常：首个可用后续失效的解决方法

嘿，我来帮你搞定Jupyter Notebook里这个目录链接失效的问题！这种情况我碰过好多次，大概率是锚点命名规则或者链接写法出了岔子，咱们一步步来排查修复：

1. 先搞懂Jupyter自动生成的锚点规则 #

Jupyter会把你的标题自动转换成符合规范的锚点，规则很简单：

• 所有字母转小写
• 空格替换成连字符-
• 特殊字符会被移除或者转义

比如你写的## Section One，对应的锚点是#section-one，而不是#Section One或者#sectionone，这是最容易踩的坑！

2. 检查目录链接的写法（分Markdown和HTML两种情况） #

如果你用的是Markdown链接：

确保链接里的锚点严格对应目标标题的自动生成格式，比如：

## 目录
- [Introduction](#introduction)  <!-- 对应 # Introduction -->
- [Section One](#section-one)    <!-- 对应 ## Section One -->
- [Section Two](#section-two)    <!-- 对应 ## Section Two -->

如果你用的是HTML链接：

同样要保证href属性里的锚点正确，比如：

<div class="toc">
  <ul>
    <li><a href="#introduction">Introduction</a></li>
    <li><a href="#section-one">Section One</a></li>
    <li><a href="#section-two">Section Two</a></li>
  </ul>
</div>

3. 手动指定标题ID（可选但更可靠） #

如果自动生成的锚点让你困惑，你可以手动给标题添加id属性，这样链接直接指向这个id就不会错了：

<h2 id="section-one">Section One</h2>

对应的链接就写成：

- [Section One](#section-one)

或者HTML版本：

<li><a href="#section-one">Section One</a></li>

4. 排查重复标题的问题 #

如果有两个完全一样的标题，Jupyter会给后面的标题锚点加上序号（比如#section-one-1），这时候你需要把目录链接改成对应的序号版本，或者给重复标题手动设置不同的id。

5. 最后试试刷新/重启Notebook #

有时候浏览器缓存或者Notebook的临时状态会导致链接不生效，你可以：

• 保存所有单元格
• 关闭Notebook标签页，重新打开
• 或者刷新页面，再测试链接

举个完整的正确示例：

## 目录
- [Introduction](#introduction)
- [Section One](#section-one)
- [Section Two](#section-two)

# Introduction
这里是你的介绍内容...

## Section One
第一部分的内容，随便写点什么...

## Section Two
第二部分的内容，继续写...

按照上面的步骤调整后，Section One和Section Two的链接应该就能正常跳转啦！

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