Improve README for GitHub

Made Markdown syntax compatible with GitHub flavoured
Markdown. Minor tweaks with some wording.