fix some formatting issues with github flavoured markdown
we'll need to try again