Currently the wiki will generate a heading based TOC automatically. In some of our documentation we'd like to link to a section of the docs from within the text as well. Right now we have to save the wiki document, then View Source on the page to see what @id was given to the headings anchor tag so we can create a #IDHERE link to that heading.

This is annoying because we have to View Source to find the ID to use and then edit the page to update our link.

It also seems fragile since that generated ID could conceivably change and break out docs.

It would be nice if the Remarkup syntax supported specifying this ID value for headings.

Something like this maybe?

== Heading with auto-generated ID (same as today)

==(specific-id) Heading with specific ID