Lint documentation markdown files with markdownlint

We could add https://github.com/igorshubovych/markdownlint-cli as pre-commit hook instead of doc8.