feat: harmonise markdown linters between pre-commit and CI

Ensure that pre-commit and gitlab-ci use the same version of the markdown lint CLI tool to ensure that results are consistent between local and remote runs.

Fix up any iddues which appeared by moving to the latest markdown lint tooling.