[perldoc] Table of Contents
There should be a Table of Contents for each individual module. Each heading should also link back to the table of contents.
Having generated <a name= entries at all would still be useful, even without the table of contents feature.
Because at least then, people could manually craft links to sections, and anchors on headings could be added later to ease giving users hyperlinks to those sections.
That bit at least seems to happen automatically with the Pod::Simple::XHTML: Each heading gets an id, which allows for the #fragment linking.
Oh. Somehow I figured this issue was about markdown ## Name -> Fragment mapping.
I'd be wanting the ability to add Markdown TOCs with section hyperrefs.