diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index aa74ce5f..6ffa57d1 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -19,6 +19,16 @@ permissions:
   contents: read
 
 jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: DavidAnson/markdownlint-cli2-action@v19
+        with:
+          globs: |
+            **/*.md
+          config: .markdownlint.json
+
   links:
     runs-on: ubuntu-latest
     steps:
diff --git a/.markdownlint.json b/.markdownlint.json
new file mode 100644
index 00000000..f272e664
--- /dev/null
+++ b/.markdownlint.json
@@ -0,0 +1,10 @@
+{
+  "default": true,
+  "MD013": false,
+  "MD024": { "siblings_only": true },
+  "MD033": false,
+  "MD041": false,
+  "MD051": false,
+  "MD025": { "front_matter_title": "" },
+  "MD007": { "indent": 2 }
+}