Add table of contents to README for better navigation.
Also update to latest markdownlint-cli.
markdownlint-cli