Reformat README as markdown

Provides syntax highlighting of code samples
Minor text edits (typos etc.)