Prettify README and docs

[gdalle]

Congrats on the registration! Here's a small contribution to help your docs look better:

• Add docs badge to README (this is the first place people will look). You should also consider updating the repo description on the top left of the GitHub page.
• Fix Markdown header nesting
• Fix Symbol display in table

[TimSiebert1]

Thank you very much!