chore(docs): add directive to pad heading anchors

Closes #2070
Closes #9360
Just curious: Why a `span` with `display:block` and not a plain `div` ?