diff --git a/.changeset/dry-gifts-joke.md b/.changeset/dry-gifts-joke.md
new file mode 100644
index 00000000000..ea6135780c9
--- /dev/null
+++ b/.changeset/dry-gifts-joke.md
@@ -0,0 +1,4 @@
+---
+---
+
+fix(docs): downgrade typedoc-plugin-markdown to fix docs site generation
diff --git a/package.json b/package.json
index 3d67dc74cd3..63dc169a754 100644
--- a/package.json
+++ b/package.json
@@ -63,7 +63,7 @@
     "lint-staged": "15.2.10",
     "prettier": "3.3.3",
     "typedoc": "^0.26.7",
-    "typedoc-plugin-markdown": "^4.2.8",
+    "typedoc-plugin-markdown": "4.2.8",
     "typescript": "^5.6.2",
     "typescript-json-schema": "0.64.0"
   },
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index bb66606b23a..0e8b09966b4 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -69,8 +69,8 @@ importers:
         specifier: ^0.26.7
         version: 0.26.11(typescript@5.7.2)
       typedoc-plugin-markdown:
-        specifier: ^4.2.8
-        version: 4.3.1(typedoc@0.26.11(typescript@5.7.2))
+        specifier: 4.2.8
+        version: 4.2.8(typedoc@0.26.11(typescript@5.7.2))
       typescript:
         specifier: ^5.6.2
         version: 5.7.2
@@ -5664,11 +5664,11 @@ packages:
   typedarray-to-buffer@3.1.5:
     resolution: {integrity: sha512-zdu8XMNEDepKKR+XYOXAVPtWui0ly0NtohUscw+UmaHiAWT8hrV1rr//H6V+0DvJ3OQ19S979M0laLfX8rm82Q==}
 
-  typedoc-plugin-markdown@4.3.1:
-    resolution: {integrity: sha512-cV0cjvNfr5keytkWUm5AXNFcW3/dd51BYFvbAVqo9AJbHZjt5SGkf2EZ0whSKCilqpwL7biPC/r1WNeW2NbV/w==}
+  typedoc-plugin-markdown@4.2.8:
+    resolution: {integrity: sha512-1EDsc66jaCjZtxdYy+Rl0KDU1WY/iyuCOOPaeFzcYFZ81FNXV8CmgUDOHri20WGmYnkEM5nQ+ooxj1vyuQo0Lg==}
     engines: {node: '>= 18'}
     peerDependencies:
-      typedoc: 0.27.x
+      typedoc: 0.26.x
 
   typedoc@0.26.11:
     resolution: {integrity: sha512-sFEgRRtrcDl2FxVP58Ze++ZK2UQAEvtvvH8rRlig1Ja3o7dDaMHmaBfvJmdGnNEFaLTpQsN8dpvZaTqJSu/Ugw==}
@@ -12144,7 +12144,7 @@ snapshots:
     dependencies:
       is-typedarray: 1.0.0
 
-  typedoc-plugin-markdown@4.3.1(typedoc@0.26.11(typescript@5.7.2)):
+  typedoc-plugin-markdown@4.2.8(typedoc@0.26.11(typescript@5.7.2)):
     dependencies:
       typedoc: 0.26.11(typescript@5.7.2)
 
diff --git a/scripts/renderer/src/typedoc2html.ts b/scripts/renderer/src/typedoc2html.ts
index bfe0bf58ea5..b4037695f35 100644
--- a/scripts/renderer/src/typedoc2html.ts
+++ b/scripts/renderer/src/typedoc2html.ts
@@ -2,6 +2,7 @@ import { copy, exists } from "fs-extra"
 import { rm } from "fs/promises"
 import * as path from "path"
 import * as typedoc from "typedoc"
+import * as process from "process"
 
 async function main() {
   const outputDir = "docs"
@@ -35,4 +36,7 @@ async function main() {
   await app.generateDocs(project!, outputDir)
 }
 
-main().catch(console.error)
+main().catch((e) => {
+  console.error(e)
+  process.exit(1)
+})