Feature request: Support click-to-jump for Markdown internal links

[haimag]

Feature request: Support click-to-jump for Markdown internal links

In Markdown, clicking internal links (anchor links) allow to jump to specific sections within the same document, making navigation in long files much more convenient, thanks.

[GitHubRulesOK]

Hmm the ToC (Outline as Bookmarks) is usually the navigation means to jump to tagged headings as shown here, but every MD may have different tagging
So A Sample file would be needed for comparison of methods.

[haimag]

Please see the sample file: https://github.com/lowRISC/opentitan/blob/master/hw/ip/adc_ctrl/doc/registers.md

Clicking the below link does not redirect

[kjk]

Fixed, will be in the next pre-release.

The problem was in the generated HTML, not in click handling: heading ids and the links pointing at them used different slug rules. We used cmark-gfm's, which turn _ into - and collapse runs of separators, so ## INTR_STATE got id="intr-state" while the document links to #intr_state. In registers.md 23 of 41 internal links pointed at ids that didn't exist, so the browser had nothing to scroll to.

Heading anchors now follow GitHub's rules (_ is kept, punctuation is dropped, and each space becomes its own -, so ### adc_intr_ctl . TRANS_EN is #adc_intr_ctl--trans_en). All 41 links in that file resolve now.

Thanks for the sample file, it made this easy to pin down.