Update docs to markdown style guide.
Merge pull request #7067 from cirosantilli/doc-md-style

Update docs to match new markdown style guide 2