Reformat the README and other docs to markdown

Move the doc files to end .md and also do some minor reformating to
make use of the Markdown format. This will make the docs more readable
on Github.