13

So there is a lot out there about creating anchors in markdown, and creating internal table-of-contents-type anchors in a notebook. What I need though is the ability to access an anchor in my notebook on Github from an external source, e.g.:

https://github.com/.../mynotebook.ipynb#thiscell

I've got a number of interactive tutorials hosted this way, and a single manual that I want to be able to link to sections of the notebooks for. I can add the anchor tags into markdown cells just fine, using: 

<a id='thiscell'></a>

but when I try using the link as I wrote above, it just loads the notebook at the top, as if there was no reference to an anchor.

Jeff
  • 2,158
  • 1
  • 16
  • 29
  • 3
    Probably this has to do with the fact that github is rendering the notebook for you, and that intermediate step is the responsible of you losing the "anchor-capabilities". I tried using **name** instead of **id**, as explained in [this post](http://stackoverflow.com/questions/6695439/how-do-you-create-link-to-a-named-anchor-in-multimarkdown) but the result was the same. – Albert Camps Jul 26 '16 at 07:32
  • This doesn't work because GitHub renders the notebook in an iframe. Anchors on the parent page URL don't apply to iframe content; anchors would need to be propagated to the ` – Martijn Pieters Dec 08 '19 at 14:31

2 Answers2

11

GitHub renders notebooks using a separate domain, render.githubusercontent.com, and integrates the output in a nested frame. This means that any anchors on the GitHub URL won't work, because the framed document is a different URL entirely.

Moreover, the framed content is not easily re-usable, as the result is a cached rendering of the notebook with a limited lifetime. You can't rely on it sticking around for later linking!

So if you need to be able to link to sections in a notebook, you'd be far better off using the Jupyter notebook viewer service, https://nbviewer.jupyter.org/. It supports showing notebooks from any public URL including GitHub-hosted repositories and GitHub gists. You can also just enter your GitHub user name (or username/repository) for quick access.

This notebook viewer is far more feature-rich than the one GitHub uses. GitHub kills all embedded JavaScript, and strips almost all HTML attributes. Any embedded animations are right out. But the Jupyter nbviewer service supports those directly out of the box.

E.g. compare these two notebooks on nbviewer:

with the same notebooks on GitHub:

The first one contains an animation at the end, the second has a complicated table made easier to read by use of some HTML styling and anchor links.

Martijn Pieters
  • 1,048,767
  • 296
  • 4,058
  • 3,343
3

I had the same problem. As a workaround, I have delegated the rendering of my notebook to http://nbviewer.jupyter.org. It's just a matter of providing its GitHub public url and clicking Go!

Of course, the internal links still don't work under GitHub, but I have now a functioning notebook somewhere on the web, which is what I actually wanted in the first place.

I hope this applies to your case too.

Aristide
  • 3,606
  • 2
  • 30
  • 50