For many years, I have flitted between a plethora of different
blogging platforms mainly out of curiosity, boredom, frustration or
occasionally sheer bloody mindedness.
I have lost draft posts in WordPress, Tumblr, Posterous and Habari due
to network glitches, browser crashes, my own stupidity and a broken
AutoSave plugin.
One night in a lonely hotel room, the realisation suddenly dawned on
me that my frustration with all of these blogging platforms was that I
spent a lot of time in the post editor and none of the post editors
did what I wanted.
Whether you use Tumblr, Posterous, WordPress, Habari, Drupal, Movable
Type, Django-Mingus or another esoteric blog platform, you normally
find yourself composing content in a Web browser within a blank text
box writing raw HTML.
Alternatively, you might be using some WYSIWYG editor that helps you
insert the appropriate HTML tags.
There are a few things wrong with this scenario as far as I'm
concerned:
-
I don't particularly want or need to learn and remember HTML tags.
People ask why there's a HTML reference card in the lavatory.
-
WYSIWYG editors can produce monstrous, bloated, ugly and sometimes,
as a bonus, invalid HTML.
-
I don't really want to use a WYSIWYG editor. I have invested time
learning to scratch the surface of the functionality provided by the
one true editor - Emacs.
After reading, but steadfastly ignoring multiple articles about
Markdown for
many months and making a mental note to investigate further, I finally
set aside 10 minutes to do so.
Without being over dramatic, Markdown has changed my life. For the
better.
Markdown is a markup language ('geddit ?') that uses a easy to read
notation as shorthand for HTML.
The beauty of the Markdown syntax is that text written in the Markdown
format is perfectly readable. This makes reading, scanning, reviewing
and editing text much easier and quicker.
I'm a simple man with simple tastes so my blog posts primarily use
paragraphs, lists, hyperlinks and the very occasional image.
A hyperlink in Markdown looks like
[Markdown](http://daringfireball.net/projects/markdown/syntax)
A blank line indicates the end of a paragraph. Again, this is how we
compose text in emails and is so much more natural than
The HTML tags above are a pre-formatted block. In Markdown, this is
simply denoted by a 4 character indent.
To emphasise a word, you simply enclose the word in asterisk
characters which is what a lot of Luddite, bearded Unix geeks tend to
do anyway. Using two asterisk characters will result in bold text.
Similarly, if you want to force a line break you simply append two
blank spaces to the end of a line.
Code blocks are enclosed by backquotes.
printf("Hello World\n");
Bulleted lists are introduced by a hyphen or asterisk character so a
list of my favourite fruits would be written as:
* Apples
* Oranges
* Pears
* Bananas
Ordered lists use numbers and look like, well, ordered lists.
1. Giggs
2. Scholes
3. Cantona
Quotes are also easy and intuitive introduced by the '>' character.
Are you still doing what you did 5 years ago ?
Yeah ? Well don't make a career out of it.
Mark E. Smith (The Fall)
Most blogging platforms either provides native Markdown support or has
plugins available to provide such functionality.
However, the real beauty of Markdown for me is that Emacs inevitably
has a powerful Markdown mode that provides font colouring, additional
menu shortcuts for the common constructs and a feature to examine the
generated HTML in an Emacs buffer or preview the results in a Web
browser.
This is incredibly useful for me as I can quickly check the generated
HTML and even validate my blog posts. Validating my posts wasn't easy
before as the addition of the Disqus Javascript code generates a
number of warnings from the W3C validator.
