Markdown fixes for the previos pull request

Most markup faulties now seems like to be fixed.