Extend README

* Format in markdown
* Expand the section on building and running
* Fix some typos