Use header cell.

[Carreau]

Read here : http://nbviewer.ipython.org/github/rasbt/python_reference/blob/master/tutorials/table_of_contents_ipython.ipynb

Do you know that header cell are made for that and will give anchor if you use them ?

[rasbt]

Thanks for the comment. Can you please explain this a little bit further...how would I get the anchor id for the 'header cell'?

[Carreau]

Since 1.0 and above, just click the header cell once render and it will change the url to give you the anchor there is just some normalisation on the text entered in the header cell : foo $ bar § < / !ç like space to dashes #foo-$-bar-§-<-/-!ç here is an example with my cursor hovering the first header cell, (invisible because of screenshot). Paragraph symbols appear on hover.

it works on cross-notebook so you can lnk othernotebook.ipynb#my-heading-1 both on live notebook and nbviewer.

#foo-$-bar-§-<-/-!ç

[rasbt]

Oh, that's really cool, thank you so much, I really didn't know this! I added it to the tutorial