Support for creating TOCs for current chapter/section about wiki.vim

[kwrobert]

The vim-pandoc plugin has a :TOC command that does something similar, but populates a quickfix window with a TOC instead of inserting the TOC in the document itself. One can jump to the headers by placing the cursor on the relevant header and pressing <CR>. You might look there for some inspiration.

This feels related so I'll add it here. I think it would be really nice to add support for jumping to Pandoc header identifiers just like we have functionality for jumping to various other flavors of links. A header identifier looks like this

# My Header {#a-unique-identifier}

What would be awesome is if we could do something like

# A Section {#the-section}

blah blah

# Another Section {#another-section}

See [this section](#the-section) 

And be able to press some keymapping when the cursor is on the [this section] link and have it jump to the header of the appropriate section. It would certainly make it easier to reference various sections in a large document, and ease navigation in large documents. What do you think?

[lervag]

Please open a new issue for the header identifiers. My initial thought is that this is already supported through the anchors, but perhaps I did not quite understand the request. So please explain why these identifiers are necessary as an alternative to the anchors.

Thanks for the comment on the :TOC command. The point of the TOC that I'm talking about here is not navigation, but to add/update an actual "table of contents" listing. I find such listings useful, in particular in long notes/pages with a lot of sections and chapters.

[lervag]

WikiPageTocLocal and the associated mapping (default <leader>wT) should now work as desired.