use markdown and tidy up the layout a bit