Heading styling in admonitions

[mortenpi]

Headings in admonitions get the same stying as the main body. They should probably be a bit smaller:

X-ref: https://github.com/JuliaLang/julia/pull/36563#discussion_r451386351

[odow]

Isn't this just a case of user-beware? To make a smaller header, use more #. Having different styling just adds complexity.

[fredrikekre]

It is a bit difficult to know what level of heading is correct if you write a docstring that will then be embedded in a document. I think it would be nice to if heading sizes where somehow relative the size of the note heading.

Having different styling just adds complexity.

This is true though, and it is pretty easy to fix it for your own case with more #.

I wonder if there are already styling differences like this for admonitions? In that case it might not be too difficult to add one more rule.