kinlane/api-evangelist — pull request #4 by benbalter (2013-07-17 18:54:40+00:00)
Title: Use markdown, wherever possible

Wherever possible, use should try to use Markdown to author content, rather than raw HTML. This has several advantages: Besides being easier to read unformatted (and easier to write), it's easier to diff, and lowers the barrier for others to contribute (because no knowledge of HTML is necessary). Jekyll will automatically convert any file with a `.md` file extension to HTML. It also further separates design from presentation, allowing you to use the same content in multiple forms.

Realize the site's coming from another medium (and it's brand new), but here's an example of converting `about.html` to `about.md` which should show no difference once rendered.

There's even [an API](http://fuckyeahmarkdown.com/#api) :smile: