Could anyone explain to me the trend to write HTML in some other markup syntax? I write HTML in HTML. Going from one markup language to another seems like an extra unnecessary prereq.
Markup syntax like markdown, asciidoc, reStructuredText, etc. strive primarily to preserve readability with the least obtrusive syntax, and with a smaller learning curve (at least for the most basic usage).
So why use it instead of HTML? Like you, I typically write HTML in HTML, but often use asciidoc for other purposes (documentation, recipes, quick notes, etc.), because:
- One source document can output to multiple formats, like XHTML, LaTeX, PDF, DocBook, EPUB, Man page, etc. It's even trivial to output to a specific HTML DOCTYPE. That's pretty neat!
- Diffs are far more readable when not swimming in markup soup.
- HTML is overkill for many purposes. In fact, lightweight markup has its roots in email/newsgroup markup. HTML email is still a compatibility nightmare. Wouldn't it be great if a new standard for rich text email was developed, based on something as simple as markdown? It would be trivial to support it in webmail interfaces and the source would still be readable in plaintext email clients or if the sender went overboard with style choices.
- Archivability. Many old HTML documents render poorly in modern browsers, mainly due to style choices that seemed sensible at the time. Lightweight markup focuses more on the content and discourages going off on a stylistic tangent you may regret later. In other words, it does a good job of separating content from presentation, so your source documents will always remain readable and transform to something readable with relatively few tweaks in external stylesheets or configuration files.
Because it's easy to learn without getting lost in the arcane details of validation and compatibility, it's understandable why it's gaining popularity.
Let's say you have a bunch of untrained writers who needs to do some semantic formatting. They don't know HTML, so you can't ask them to just write HTML. If you let them run rampant with a WYSIWYG word processor (probably Word) you'll wind up with monstrosities where fonts were manually bolded and enlarged to indicate headers and such, and someone has to clean up after it.
If you have Markdown editors, though, you can turn an untrained writer loose with a cheat sheet ("write # to get a header" and such) and you're all set. As a bonus, you can put the Markdown document in version control, export to formats besides HTML, and a few other useful things.
Some major websites like reddit have also successfully made use of Markdown and its competitors to permit rich text comments from people who know nothing about HTML.
I would't say markdown is any easier to write because the verbosity of HTML tags and structure is usually taken care of with editor macros. It's definitely easier to read the source though.
Do others keep their final versions in Markdown?