I had never heard of Setext! I do know that, before Markdown became popular, lots of programmers had their own similar format going on - this was mine, from 1998:
Perl program https://sourceforge.net/p/rosegarden/code/HEAD/tree//branche...
Documentation https://sourceforge.net/p/rosegarden/code/HEAD/tree//branche...
I wonder now how much of this was picked up unknowingly from Setext-derived documents.
> In some editors/IDE, the underline even gets highlighted / boldfaced, thereby exacerbating this effect.
I think a lot of editors just don't know about this style of heading, but they do know that a line of three or more dashes is used to create a horizontal rule, so they're trying to highlight that.