Improve doc comment readability; add markdown heading colors.

Doc comments were hard to read when using the light background. Darkened
it up somewhat. Also added colors for headings 2 and 3 in Markdown.