generate the TOC inside the MD file

[jmvanel]

To automatize the TOC generation,
it would be nice that gh-md-toc generates the TOC inside the MD file, instead of generating some text that user has to manually insert at the desired position.

So, if the markdown file has a marker like:

<!-- TOC -->

gh-md-toc generates or re-generates the TOC at this position.
To re-generate the TOC, and delete the old TOC, the end of TOC could be marked by something like:

<!-- gh-md-toc end , generated at samedi 25 novembre 2017, 04:08:42 (UTC+0100) by jmv -->

[ekalinin]

Hey,

Makes sense.

PS:
There's the same issue in go project:

• [Feature] Write the TOC somewhere in the markdown github-markdown-toc.go#7

[dannguyen]

FWIW, this is a feature of https://github.com/thlorenz/doctoc. It's handy, not just because it saves the user from having to do a manual-copy-and-paste, but sometimes the README.md has headline tags that aren't desired to be in the toc (such as a top-level headline for the entire file)