Any inline code block inside a header gets rendered with the same font-size
as normal paragraphs, and this makes code look very inappropriate inside headers.
For example, the following Markdown:
Just a regular header, with some `code` in it
====
Just a regular paragraph.
Produces this output:
NOTE: same goes for smaller headers
I mean, what's this? Ewww. Please take a look at it and update the CSSs!
XDocument
", for instance? Doesn't seem that outlandish to me.XDocument
example is a good one.XDocument
situation @LightnessRacesinOrbit disagrees with, here the code (1) meaningfully identifies different sections; and (2) must be code-formatted, otherwise it will be illegible; it's not just a single identifier.