README: Add build status badge and minor clean up

Use the same level 2 heading syntax for consistency (not mixing
the ------------ and ## syntax).

Minor copy-edit:
- Space
- Sentence case
- No colon at the end of a heading
- Identation fix in the html sample