diff --git a/cspell.config.yaml b/cspell.config.yaml
index 0f3a55f17..ad68f6e4c 100644
--- a/cspell.config.yaml
+++ b/cspell.config.yaml
@@ -122,6 +122,7 @@ words:
   - magnifer
   - Maru
   - matchall
+  - mdit
   - micvad
   - mineflayer
   - mingcute
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index a3db5e7b8..1b12d5330 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -1,5 +1,7 @@
 import type { DefaultTheme } from 'vitepress'
 
+import { env } from 'node:process'
+
 import anchor from 'markdown-it-anchor'
 import unocss from 'unocss/vite'
 
@@ -51,6 +53,7 @@ export default defineConfig({
     ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
     ['link', { rel: 'mask-icon', href: '/logo.svg', color: '#ffffff' }],
   ],
+  base: env.BASE_URL || '/',
   lastUpdated: true,
   sitemap: { hostname: ogUrl },
   themeConfig: {
diff --git a/docs/package.json b/docs/package.json
index 806d46b45..1397d8c20 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -4,7 +4,7 @@
   "version": "2.3.1",
   "scripts": {
     "build": "vitepress build",
-    "build:base": "vitepress build --base /docs/",
+    "build:base": "BASE_URL=/docs/ vitepress build",
     "dev": "vitepress dev",
     "preview": "vitepress preview",
     "typecheck": "vue-tsc --noEmit",