Docs: fix markdown in various files, update the README mildly

Review URL: https://codereview.chromium.org/678693003