Fixed heading sections to use markdown

Noticed that many of the section headers in this doc were using raw
HTML (e.g. <h2>) tags and were therefore duplicating the text in each
of those titles. Fixed to use proper markdown syntax.
manually merging pr #2177