Reformat the README and other docs to markdown

Fresh pull request on the new master branch.

Move the doc files to end .md and also do some minor reformatting to
make use of the Markdown format. This will make the docs more readable
on Github.