如何让Jupyter Notebook中的书签链接在GitHub上正常生效？

Yep, I’ve run into this exact issue before—super frustrating when links work locally but break on GitHub! The root cause is that GitHub’s renderer for Jupyter Notebooks handles header anchors differently than the local Jupyter environment. Here’s what’s going on and how to fix it:

Why the links break #

Local Jupyter uses one set of rules to generate anchor IDs for headers (like preserving uppercase letters or using underscores), but GitHub converts headers to all lowercase, replaces spaces with hyphens (-), strips special characters, and adds suffixes like -1 for duplicate headers. If your links use the local-style anchors, they won’t match what GitHub generates.

Fixes to try: #

• Copy the exact anchor from GitHub: After pushing your notebook to GitHub, navigate to the header you want to link to. Right-click the header and select "Copy link address" (or similar, depending on your browser). The part after the # in that URL is the anchor you need to use. For example, if the copied link is https://github.com/your/repo/blob/main/Investigating_Database.ipynb#investigating-database-structure, your Markdown link should be [Database Structure](#investigating-database-structure).
• Adjust your Markdown links manually: If you don’t want to push first, follow GitHub’s anchor rules:
  1. Convert the header text to lowercase.
  2. Replace spaces and underscores with hyphens.
  3. Remove any non-alphanumeric characters (like !, ?, :).
  4. For duplicate headers, add -1, -2, etc., at the end (e.g., two ## Results headers become #results and #results-1).
• Avoid HTML anchor tags: Skip using <a href="#anchor"> HTML links—GitHub’s notebook renderer doesn’t parse these consistently with local Jupyter. Stick to standard Markdown links instead.

Example #

If your local notebook has a header:

## Exploring Table Relationships

Local Jupyter might use the anchor #Exploring_Table_Relationships, but GitHub will generate #exploring-table-relationships. So your working link on GitHub should be:

[Exploring Table Relationships](#exploring-table-relationships)

Once you update your links to match GitHub’s anchor format, they should start working when clicked on the repo page.

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