I find reStructuredText much better option for lightweight markup as it is
comparably lightweight to markdown but there is only one version, is much
more powerfull, and makes more sense to me syntactically. Org-Mode looks
just like another markdown to me.
> Even worse than this is the underlined heading category.
I think its the best. Compared to the prefix style it actually looks like
a headline in the text document.
> The user is completely irritated for multiple reasons. Besides the tedious manual work to align the stupid heading characters with the heading title
What is tedious on typing <esc>yyp <shift>-v r # to underline current
line with #?
> it is not clear what characters must be used for those heading lines. If you've got a bigger document with different levels of headings you get confused which heading character stands for which heading level.
Using a convention where bigger headlines use bigger looking characters
works for me.
H1 uses # and is both under and overlined, the rest is only underlined
H2 uses #
H3 uses =
H4 uses -
> > The user is completely irritated for multiple reasons. Besides the tedious manual work to align the stupid heading characters with the heading title
> What is tedious on typing <esc>yyp <shift>-v r # to underline current line with #?
Also, there is the "easy" approach where you just fill the line instead (insert 72 #s or =s or whichever on under/over-lines). reStructuredText has a minimum fill size for a header, but not a maximum fill size.
I've drafted documents that way and then trimmed the lines down to fit the headers as a last step once they have stabilized.
I really like RST for documents that need 'a bit more' syntax than allowed by plain markdown. Especially references and so on. But then, the minimalism of bare bones markdown means that the text is very legible even without any special editor support.
> Even worse than this is the underlined heading category.
I think its the best. Compared to the prefix style it actually looks like a headline in the text document.
> The user is completely irritated for multiple reasons. Besides the tedious manual work to align the stupid heading characters with the heading title
What is tedious on typing <esc>yyp <shift>-v r # to underline current line with #?
> it is not clear what characters must be used for those heading lines. If you've got a bigger document with different levels of headings you get confused which heading character stands for which heading level.
Using a convention where bigger headlines use bigger looking characters works for me.