Readme conversion

Nicer to edit in markdown given all the inline code. Also nicer for contributors to edit on github.com.