TOC should use anchors generated from the headings

[koppor]

Please directly the IDs of the generated HTML headings and do not introduce additional <div> tags. See also http://stackoverflow.com/a/27953547/873282

Currently, the script outputs something like following

#Summary 

  - [Generic code how tos](#section-id-3)

<div id='section-id-3'/>

## Generic code how tos

I would have expected following

#Summary 

  - [Generic code how tos](#generic-code-how-tos)

## Generic code how tos

An existing ruby implementation is provided at https://gist.github.com/albertodebortoli/9310424 (via http://stackoverflow.com/a/22131019/873282).

[velthune]

Hi koppor.
Introducing

is exactly what I want!
I do in this way in order to associate user's section click to the related paragraph.
Removing div, nothing happen on section click, isn't it?

[koppor]

Please check https://github.com/JabRef/jabref/wiki/Code-Howtos#table-of-contents (as an example). The GitHub markdown converter automatically adds anchors:

<a id="user-content-throwing-and-catching-exceptions" class="anchor" href="#throwing-and-catching-exceptions" aria-hidden="true">

[Kreinoee]

But thats a Github thing, not a generic markdown. Some markdown to html converters does not add these anchors automatically, and it this cases it won't work without the divs (or something else to add the anchors.

So if this is to be implemented, it should be as an option, mayby by invoking the script with --no-anchors or something like that.

[neikei]

Unfortunately this project isn't maintained anymore, but I implemented the anchors generated from the headlines in this fork to use it on my github pages.

[koppor]

In the meantime, I switched to markdown-toc.