diff --git a/packages/core/package.json b/packages/core/package.json
index 3ba905d68..42c992cd4 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -100,7 +100,7 @@
     "@types/html-to-text": "^9.0.4",
     "@types/jest": "~29.5.14",
     "@types/lodash-es": "^4.17.12",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^18.11.17",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
diff --git a/packages/plugin-api-docgen/package.json b/packages/plugin-api-docgen/package.json
index 1a74226df..d3a7e38f2 100644
--- a/packages/plugin-api-docgen/package.json
+++ b/packages/plugin-api-docgen/package.json
@@ -33,7 +33,7 @@
   "devDependencies": {
     "@microsoft/api-extractor": "^7.49.1",
     "@rslib/core": "0.3.2",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^18.11.17",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
diff --git a/packages/plugin-container-syntax/package.json b/packages/plugin-container-syntax/package.json
index 615ca1ef0..8b2f37019 100644
--- a/packages/plugin-container-syntax/package.json
+++ b/packages/plugin-container-syntax/package.json
@@ -35,7 +35,7 @@
   "devDependencies": {
     "@microsoft/api-extractor": "^7.49.1",
     "@rslib/core": "0.3.2",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "mdast-util-mdx-jsx": "^2.1.4",
     "rehype-stringify": "^9.0.4",
     "remark-directive": "^2.0.1",
diff --git a/packages/plugin-playground/package.json b/packages/plugin-playground/package.json
index 5575281c7..c8c1f9a49 100644
--- a/packages/plugin-playground/package.json
+++ b/packages/plugin-playground/package.json
@@ -48,7 +48,7 @@
     "@types/babel__core": "^7.20.5",
     "@types/babel__standalone": "^7.1.9",
     "@types/babel__traverse": "^7.20.6",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^18.11.17",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
diff --git a/packages/plugin-preview/package.json b/packages/plugin-preview/package.json
index 7f360aed5..1c678038f 100644
--- a/packages/plugin-preview/package.json
+++ b/packages/plugin-preview/package.json
@@ -37,7 +37,7 @@
   "devDependencies": {
     "@rslib/core": "0.3.2",
     "@types/lodash": "^4.17.14",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "@types/node": "^18.11.17",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
diff --git a/packages/theme-default/package.json b/packages/theme-default/package.json
index 263684910..34e5bb1fd 100644
--- a/packages/theme-default/package.json
+++ b/packages/theme-default/package.json
@@ -67,7 +67,7 @@
     "@types/hast": "3.0.4",
     "@types/jest": "~29.5.14",
     "@types/lodash-es": "^4.17.12",
-    "@types/mdast": "^3.0.15",
+    "@types/mdast": "^4.0.4",
     "@types/nprogress": "^0.2.3",
     "@types/react": "^18.3.18",
     "@types/react-dom": "^18.3.5",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index f8bd7dac7..61eb7e4ef 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -829,8 +829,8 @@ importers:
         specifier: ^4.17.12
         version: 4.17.12
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       '@types/node':
         specifier: ^18.11.17
         version: 18.11.17
@@ -991,8 +991,8 @@ importers:
         specifier: 0.3.2
         version: 0.3.2(@microsoft/api-extractor@7.49.1(@types/node@18.11.17))(typescript@5.5.3)
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       '@types/node':
         specifier: ^18.11.17
         version: 18.11.17
@@ -1105,8 +1105,8 @@ importers:
         specifier: 0.3.2
         version: 0.3.2(@microsoft/api-extractor@7.49.1(@types/node@22.10.2))(typescript@5.7.2)
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       mdast-util-mdx-jsx:
         specifier: ^2.1.4
         version: 2.1.4
@@ -1246,8 +1246,8 @@ importers:
         specifier: ^7.20.6
         version: 7.20.6
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       '@types/node':
         specifier: ^18.11.17
         version: 18.11.17
@@ -1319,8 +1319,8 @@ importers:
         specifier: ^4.17.14
         version: 4.17.14
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       '@types/node':
         specifier: ^18.11.17
         version: 18.11.17
@@ -1619,8 +1619,8 @@ importers:
         specifier: ^4.17.12
         version: 4.17.12
       '@types/mdast':
-        specifier: ^3.0.15
-        version: 3.0.15
+        specifier: ^4.0.4
+        version: 4.0.4
       '@types/nprogress':
         specifier: ^0.2.3
         version: 0.2.3
@@ -3277,6 +3277,9 @@ packages:
   '@types/mdast@3.0.15':
     resolution: {integrity: sha512-LnwD+mUEfxWMa1QpDraczIn6k0Ee3SMicuYSSzS6ZYl2gKS09EClnJYGd8Du6rfc5r/GZEk5o1mRb8TaTj03sQ==}
 
+  '@types/mdast@4.0.4':
+    resolution: {integrity: sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==}
+
   '@types/mdx@2.0.6':
     resolution: {integrity: sha512-sVcwEG10aFU2KcM7cIA0M410UPv/DesOPyG8zMVk0QUDexHA3lYmGucpEpZ2dtWWhi2ip3CG+5g/iH0PwoW4Fw==}
 
@@ -8502,6 +8505,10 @@ snapshots:
     dependencies:
       '@types/unist': 2.0.7
 
+  '@types/mdast@4.0.4':
+    dependencies:
+      '@types/unist': 3.0.2
+
   '@types/mdx@2.0.6': {}
 
   '@types/ms@0.7.31': {}