More minor doc fixes.
Change doxygen syntax to use markdown.
Use markdown for parameter lists.
Use markup for parameter lists.