diff --git a/docs/.markdownlint-cli2.jsonc b/docs/.markdownlint-cli2.jsonc
deleted file mode 100644
index dba1df3f..00000000
--- a/docs/.markdownlint-cli2.jsonc
+++ /dev/null
@@ -1,23 +0,0 @@
-{
-    "config": {
-        "default": true,
-        "line-length": {
-          "strict": true,
-          "code_blocks": false,
-          "line_length": 100
-        },
-
-        // part of the markdownlint-rule-relative-links plugin
-        "relative-links": true
-    },
-    "globs": [
-        "**/*.{md,mdx}"
-    ],
-    "ignores": [
-        "node_modules",
-        "static"
-    ],
-    "customRules": [
-        "markdownlint-rule-relative-links"
-    ]
-}
diff --git a/docs/.markdownlint-cli2.mjs b/docs/.markdownlint-cli2.mjs
new file mode 100644
index 00000000..4527e0a0
--- /dev/null
+++ b/docs/.markdownlint-cli2.mjs
@@ -0,0 +1,25 @@
+import relativeLinksRule from "markdownlint-rule-relative-links"
+
+const config = {
+    config: {
+        default: true,
+        "line-length": {
+            strict: true,
+            code_blocks: false,
+            line_length: 100
+        },
+
+        // part of the markdownlint-rule-relative-links plugin
+        "relative-links": true
+    },
+    globs: [
+        "**/*.{md,mdx}"
+    ],
+    ignores: [
+        "node_modules",
+        "static"
+    ],
+    customRules: [relativeLinksRule],
+}
+
+export default config
diff --git a/docs/package.json b/docs/package.json
index 27361036..ec654eae 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -15,7 +15,8 @@
     "prettier:check": "prettier --check \"**/*.{js,jsx,ts,tsx}\"",
     "prettier:write": "prettier --write \"**/*.{js,jsx,ts,tsx}\"",
     "test": "yarn run prettier:write && yarn run markdownlint-cli2 --fix",
-    "test-check": "yarn run prettier:check && yarn run markdownlint-cli2"
+    "test-check": "yarn run prettier:check && yarn run markdownlint-cli2 --config .markdownlint-cli2.mjs",
+    "lint:markdown": "markdownlint-cli2"
   },
   "dependencies": {
     "@docusaurus/core": "^3.0.1",
@@ -61,7 +62,7 @@
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "markdownlint-cli2": "^0.14.0",
-    "markdownlint-rule-relative-links": "^3.0.0",
+    "markdownlint-rule-relative-links": "^4.0.1",
     "postcss": "^8.4.32",
     "postcss-preset-mantine": "^1.11.1",
     "postcss-simple-vars": "^7.0.1",
diff --git a/docs/yarn.lock b/docs/yarn.lock
index 35bc5445..ce1b6d0e 100644
--- a/docs/yarn.lock
+++ b/docs/yarn.lock
@@ -7994,10 +7994,10 @@ markdownlint-micromark@0.1.10:
   resolved "https://registry.yarnpkg.com/markdownlint-micromark/-/markdownlint-micromark-0.1.10.tgz#a77a1a70adad9eac18ff412baf36a0c2189875d7"
   integrity sha512-no5ZfdqAdWGxftCLlySHSgddEjyW4kui4z7amQcGsSKfYC5v/ou+8mIQVyg9KQMeEZLNtz9OPDTj7nnTnoR4FQ==
 
-markdownlint-rule-relative-links@^3.0.0:
-  version "3.0.0"
-  resolved "https://registry.yarnpkg.com/markdownlint-rule-relative-links/-/markdownlint-rule-relative-links-3.0.0.tgz#e4de472298f3859c51ea3e421350cf7649bbef12"
-  integrity sha512-+Ek2J8kXKtL8IcjmPYBsxtS37etKIbPE85aj/ehwSlxcWIlT0BCsA/SPHZlIICiZON786XVrLStMCJ1x25D3oA==
+markdownlint-rule-relative-links@^4.0.1:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/markdownlint-rule-relative-links/-/markdownlint-rule-relative-links-4.0.1.tgz#3db474bcb4b5c9b6cf7d7095103428ff36e3e3f2"
+  integrity sha512-tLr8YVR1qeZfMsixFtj49N0ABrPZpTFqk0cz6+j4zB9ZIJ9diiQ7f+npykTeGYvPUVkf5Zw8y4U0JDGGsU+zKQ==
   dependencies:
     markdown-it "14.1.0"