diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index f339797d16ea..aef1be7581d9 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -7,12 +7,16 @@ on:
       - release-*
     paths:
       - '**.md'
+      - .github/workflows/docs.yml
+      - .github/workflows/markdownlint-config.jsonc
   pull_request:
     branches:
       - main
       - release-*
     paths:
       - '**.md'
+      - .github/workflows/docs.yml
+      - .github/workflows/markdownlint-config.jsonc
 jobs:
   lint:
     name: Lint markdown
@@ -21,5 +25,6 @@ jobs:
       - uses: actions/checkout@v4
       - uses: articulate/actions-markdownlint@v1
         with:
-          config: .github/workflows/markdownlint-config.json
+          config: .github/workflows/markdownlint-config.jsonc
           ignore: autopilot
+          version: 0.39.0
diff --git a/.github/workflows/markdownlint-config.json b/.github/workflows/markdownlint-config.jsonc
similarity index 60%
rename from .github/workflows/markdownlint-config.json
rename to .github/workflows/markdownlint-config.jsonc
index c83d4850895b..a43cd6fc6ef3 100644
--- a/.github/workflows/markdownlint-config.json
+++ b/.github/workflows/markdownlint-config.jsonc
@@ -4,5 +4,7 @@
   "no-bare-urls": false,
   "first-line-h1": false,
   "single-trailing-newline": false,
-  "ol-prefix": "one_or_ordered"
+  "ol-prefix": "one_or_ordered",
+  "MD055": false, // broken
+  "MD056": false // broken
 }