alt Hacker NewsUnfortunately, the plain text does not look good, and does not offer good control of the typesetting. At least, nearly all markdown I see is almost unreadable in its “raw” state. I’d much rather read manually formatted, monospaced, text. That way, you can use asterisks as bullets, as footnote markers and as emphasis markers all at the same time, and anyone who is familiar with normal typographic conventions will understand what is what.
+1
Not too long ago, I used to think that Markdown was the Bee‘s knees. But having been forced to write some documentation in plaintext, I learned that plaintext is significantly more readable than raw markdown.
I think one of Markdown‘s biggest sins is how it handles line breaks. Single line breaks being discarded in the output guarantees that your nicely formatted text will look worse when rendered. I understand there are use cases for this. But this and the „add a trailing space“ workaround are particularly terrible for code documentation.