Markdownlint (#3209)

* pre-commit exclude tests/files (prev .*test_files)

* add pre-commit hook https://github.com/igorshubovych/markdownlint-cli

* auto-format CHANGES.md

* auto-fix white space

---------

Co-authored-by: Shyue Ping Ong <[email protected]>

Author: janosh

.pre-commit-config.yaml

@@ -1,4 +1,4 @@
-exclude: ^(docs|.*test_files|cmd_line|tasks.py)
+exclude: ^(docs|tests/files|cmd_line|tasks.py)
 
 ci:
   autoupdate_schedule: monthly
@@ -8,7 +8,7 @@ ci:
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.0.281
+    rev: v0.0.282
     hooks:
       - id: ruff
         args: [--fix]
@@ -45,3 +45,13 @@ repos:
       - id: cython-lint
         args: [--no-pycodestyle]
       - id: double-quote-cython-strings
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.35.0
+    hooks:
+      - id: markdownlint
+        # MD013: line too long
+        # MD033: no inline HTML
+        # MD041: first line in a file should be a top-level heading
+        args: [--disable, MD013, MD033, MD041, "--"]
+        exclude: ^(CHANGES.md)