Update docs to match new markdown style guide 2
Created by: cirosantilli
Same as https://github.com/gitlabhq/gitlabhq/pull/6863 but I deleted my fork before merge.
Created by: cirosantilli
Same as https://github.com/gitlabhq/gitlabhq/pull/6863 but I deleted my fork before merge.