diff --git a/docs-src/package.json b/docs-src/package.json
index f533179e4..ccc71d149 100644
--- a/docs-src/package.json
+++ b/docs-src/package.json
@@ -20,7 +20,7 @@
     "starlight-typedoc": "^0.18.0",
     "tailwindcss": "^3.4.17",
     "typedoc": "^0.26.7",
-    "typedoc-plugin-markdown": "4.2.9",
+    "typedoc-plugin-markdown": "4.7.1",
     "typescript": "^5.7.3"
   },
   "devDependencies": {
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index d33a842a0..e0065c70e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -88,7 +88,7 @@ importers:
         version: link:../shepherd.js
       starlight-typedoc:
         specifier: ^0.18.0
-        version: 0.18.0(@astrojs/starlight@0.31.1(astro@5.2.4(@types/node@24.0.14)(jiti@1.21.6)(rollup@4.46.1)(terser@5.31.3)(typescript@5.7.3)(yaml@2.8.0)))(typedoc-plugin-markdown@4.2.9(typedoc@0.26.7(typescript@5.7.3)))(typedoc@0.26.7(typescript@5.7.3))
+        version: 0.18.0(@astrojs/starlight@0.31.1(astro@5.2.4(@types/node@24.0.14)(jiti@1.21.6)(rollup@4.46.1)(terser@5.31.3)(typescript@5.7.3)(yaml@2.8.0)))(typedoc-plugin-markdown@4.7.1(typedoc@0.26.7(typescript@5.7.3)))(typedoc@0.26.7(typescript@5.7.3))
       tailwindcss:
         specifier: ^3.4.17
         version: 3.4.17
@@ -96,8 +96,8 @@ importers:
         specifier: ^0.26.7
         version: 0.26.7(typescript@5.7.3)
       typedoc-plugin-markdown:
-        specifier: 4.2.9
-        version: 4.2.9(typedoc@0.26.7(typescript@5.7.3))
+        specifier: 4.7.1
+        version: 4.7.1(typedoc@0.26.7(typescript@5.7.3))
       typescript:
         specifier: ^5.7.3
         version: 5.7.3
@@ -8559,11 +8559,11 @@ packages:
     resolution: {integrity: sha512-s6zVrxuyKbbAsSAD5ZPTB77q4YIdRctkTbJ2/Dqlinwz+8ooH2gd+YA7VA6Pa93KML9GockVvoxjZ2vHP+mu8g==}
     engines: {node: '>=16'}
 
-  typedoc-plugin-markdown@4.2.9:
-    resolution: {integrity: sha512-Wqmx+7ezKFgtTklEq/iUhQ5uFeBDhAT6wiS2na9cFLidIpl9jpDHJy/COYh8jUZXgIRIZVQ/bPNjyrnPFoDwzg==}
+  typedoc-plugin-markdown@4.7.1:
+    resolution: {integrity: sha512-HN/fHLm2S6MD4HX8txfB4eWvVBzX/mEYy5U5s1KTAdh3E5uX5/lilswqTzZlPTT6fNZInAboAdFGpbAuBKnE4A==}
     engines: {node: '>= 18'}
     peerDependencies:
-      typedoc: 0.26.x
+      typedoc: 0.28.x
 
   typedoc@0.26.7:
     resolution: {integrity: sha512-gUeI/Wk99vjXXMi8kanwzyhmeFEGv1LTdTQsiyIsmSYsBebvFxhbcyAx7Zjo4cMbpLGxM4Uz3jVIjksu/I2v6Q==}
@@ -19080,12 +19080,12 @@ snapshots:
       '@stablelib/base64': 1.0.1
       fast-sha256: 1.3.0
 
-  starlight-typedoc@0.18.0(@astrojs/starlight@0.31.1(astro@5.2.4(@types/node@24.0.14)(jiti@1.21.6)(rollup@4.46.1)(terser@5.31.3)(typescript@5.7.3)(yaml@2.8.0)))(typedoc-plugin-markdown@4.2.9(typedoc@0.26.7(typescript@5.7.3)))(typedoc@0.26.7(typescript@5.7.3)):
+  starlight-typedoc@0.18.0(@astrojs/starlight@0.31.1(astro@5.2.4(@types/node@24.0.14)(jiti@1.21.6)(rollup@4.46.1)(terser@5.31.3)(typescript@5.7.3)(yaml@2.8.0)))(typedoc-plugin-markdown@4.7.1(typedoc@0.26.7(typescript@5.7.3)))(typedoc@0.26.7(typescript@5.7.3)):
     dependencies:
       '@astrojs/starlight': 0.31.1(astro@5.2.4(@types/node@24.0.14)(jiti@1.21.6)(rollup@4.46.1)(terser@5.31.3)(typescript@5.7.3)(yaml@2.8.0))
       github-slugger: 2.0.0
       typedoc: 0.26.7(typescript@5.7.3)
-      typedoc-plugin-markdown: 4.2.9(typedoc@0.26.7(typescript@5.7.3))
+      typedoc-plugin-markdown: 4.7.1(typedoc@0.26.7(typescript@5.7.3))
 
   start-server-and-test@2.0.10:
     dependencies:
@@ -19487,7 +19487,7 @@ snapshots:
 
   type-fest@4.33.0: {}
 
-  typedoc-plugin-markdown@4.2.9(typedoc@0.26.7(typescript@5.7.3)):
+  typedoc-plugin-markdown@4.7.1(typedoc@0.26.7(typescript@5.7.3)):
     dependencies:
       typedoc: 0.26.7(typescript@5.7.3)