Clean up readme

Add some examples and tidy up the formatting of the markdown to make it read better as plain text.
Should this be an actual link to https://github.com/alphagov/specialist-publisher?