Made the markdowns compatible to other parsers like http://kramdown.rubyforge.org/

Some parsers, like [karmdown](http://kramdown.rubyforge.org/), expects an empty line before headings, so added one in routing.php (where it was missing with respect the entire documentation standard). Also converted html markup used in html.md to standard markdown to make it compatible with the convention followed in this & any other documentation files.