Fix formatting issues with the documentation to adapt to github flavoured markdown.