Double Paragraph marker in headers

[swheaton]

It seems like headers have a double paragraph marker. They show up all the time on every header. Then if I hover it makes a second clickable paragraph marker. I would expect there's no paragraph marker all the time and the behavior of the second one should actually the first and only one.

Mac, Chrome browser

[thesteve0]

Yeah it is in all browsers. Known issue. I don't think of this as a blocker for launch but it can't stay this way.
We have anchors in the original pages AND mkdocs take markdown headers and automagically turns them into anchors.

I am tempted to remove all of our inline anchor references and just let mkdocs create anchors automagically. This feels friendlier to authors and more sustainable as a practice.
Thoughts?

[swheaton]

Seems reasonable weighed against seeing the paragraph thingy all over the place.
As a frequent docs contributor, I sometimes like using explicit anchors because then I don't have to guess what the header is gonna turn into. especially if 2 headers have the same text. And Sphinx would automatically create anchors unless you specified an explicit one.
So I guess if mkdocs could do that, it would be ideal. But relying solely on automagic anchors is fine too.