After all these years of casually using it, I'm actually reading the original markdown spec. It's actually really clever how it codifies common conventions for drafting digital text. Each document markup standard -- roff, tex, html, markdown -- seem to be a step towards readability, that's for sure. Though I am left thinking that markdown, with all of the various variants, has inherited the issue that shell scripts have where one must be cognisant of the common standard.