Clean up readme

Add some examples and tidy up the formatting of the markdown to make it read better as plain text.
It definitely should, I'll fix that