Doc markdown

Covert docs to use markdown
What should these lines look like? If I just leave them their formatting gets messed up when viewed on GitHub.