Some adjustments to the text, closer to proper markdown. Better examples
Adjustments to the markdown to make it presentable