Update docs to match new markdown style guide 2

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