Add linting of markdown files

### What's needed?

We need to make sure all markdown files have a consistent style.

### Proposed solution

Use https://github.com/markdownlint/markdownlint to lint markdown files.

### Use cases

_No response_

### Alternatives and workarounds

_No response_

### Additional context

_No response_