Clean up readme

Add some examples and tidy up the formatting of the markdown to make it read better as plain text.
Did your find and replace for @tommyp 's comment catch this one by accident? :)