[TASK] Improve README formatting

This change makes the README look nicer on github, and read better when
reading it in plain text (ie it removes the <pre><code> tags preferring
the markdown-esque way of marking code sections ```code```