Update docs to match new markdown style guide.

Same as https://github.com/gitlabhq/gitlabhq/pull/6863 but I deleted my fork before merge.