just some markdown improvements
Merge pull request #1748 from merrin/patch-1

just some markdown improvements