I have for a long time been a fan of writing everything as plain text. This started with me using LaTeX, which I still do when I want a perfectly formatted result. However, the last few years I have taken to using some of the many Markdown variants available. This has several advantages: First and foremost, the source is perfectly readable as-is, which makes it ideal for readme files and the like. And you can generate multiple output formats, depending of course on what markdown variant you use.
I initially started using Asciidoc, which is really good, and can generate output in HTML, PDF, ODF, and several different slideshow formats. However, it is not based on standard Markdown, but uses it’s own slightly different syntax. This is annoying if you sometimes also need to use normal Markdown. Recently I have switched to Pandoc, which is based on MultiMarkdown syntax with some extensions. It can generate oodles of different output formats, several of them text based, which for instance makes it easy to write MediaWiki pages. I always have problems remembering MediaWiki’s fiddly syntax, and having to write things like '''''bla'''''
just makes me cringe. Continue reading →