Rework anchors for accessibility.
What does this MR do and why?
This is a second run at !76 (merged) (reverted in !108 (merged)); see gitlab-org/gitlab!183564 (merged) for the MR against GitLab and Heading anchor links aren't announced correctly... (gitlab-org/gitlab#463385 - closed) for the parent issue.
We introduce the new output style as an option, so we can opt into its use, or remove it later.
Edited by Asherah Connor