Consistent mass unit in docs + minor fixes

Fixes #99 (closed)

Changes made in this Pull Request:

• Consistent density units ins examples and docstring
• Fixed some markup in docs. Mostly rst requires ``xxx`` instead of `xxx` as in markdown

PR Checklist

• Docs?
• Issue raised/referenced?