Clean up readme

Add some examples and tidy up the formatting of the markdown to make it read better as plain text.