docs: update readme style

Using MarkdownLint in VSCode, this file was showing many linter errors,
mostly around whitespace issues, but a few others that made it annoying
enough when looking at the file, it was inconsistent and difficult to
read.

Also handles a few existing notes about caching.

Refs #412
Resolves #420
Resolves #424

Signed-off-by: Mike Fiedler <miketheman@gmail.com>

Author: miketheman