ENH: render particle name in Markdown as code

[redeboer]

Example Markdown table


Additional improvements to the docs in the commit history