Consider enabling linting of markdown files

[satazor]

So that code blocks are validated.

See: https://www.npmjs.com/package/eslint-plugin-markdown

[acostalima]

More or less related to this, what about linting markdown documents as a whole with remark-lint? 🤔