fix markdown formatting in README

Use of "C*" in the markdown text leads to some unexpected formatting
when viewing the README on github.com.

also fix some typos