Update markdown.md

Extensive rewrite.