From 5e12ef7f13cf168287f12e9c0ca29dc9e468fa37 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Wed, 4 Feb 2026 19:27:14 +0530
Subject: [PATCH 1/2] docs: format

---
 docs/en/reference/default-theme-search.md     |    2 +-
 docs/en/reference/runtime-api.md              |    2 +-
 docs/es/reference/default-theme-search.md     |    2 +-
 docs/es/reference/runtime-api.md              |    2 +-
 docs/fa/reference/default-theme-search.md     |    2 +-
 docs/fa/reference/runtime-api.md              |    2 +-
 docs/ja/guide/cms.md                          |   58 +-
 docs/ja/guide/custom-theme.md                 |   76 +-
 docs/ja/guide/data-loading.md                 |   10 +-
 docs/ja/guide/deploy.md                       |  252 ++--
 docs/ja/guide/extending-default-theme.md      |    4 +-
 docs/ja/guide/frontmatter.md                  |   34 +-
 docs/ja/guide/getting-started.md              |    2 +-
 docs/ja/guide/markdown.md                     | 1013 ++++++++---------
 docs/ja/guide/mpa-mode.md                     |   18 +-
 docs/ja/guide/routing.md                      |  424 +++----
 docs/ja/guide/sitemap-generation.md           |   78 +-
 docs/ja/guide/ssr-compat.md                   |  178 +--
 docs/ja/guide/using-vue.md                    |  232 ++--
 docs/ja/reference/cli.md                      |   68 +-
 docs/ja/reference/default-theme-badge.md      |   66 +-
 docs/ja/reference/default-theme-carbon-ads.md |   26 +-
 docs/ja/reference/default-theme-config.md     |  620 +++++-----
 docs/ja/reference/default-theme-edit-link.md  |   78 +-
 docs/ja/reference/default-theme-home-page.md  |    1 +
 docs/ja/reference/default-theme-search.md     |    2 +-
 docs/ja/reference/runtime-api.md              |    2 +-
 docs/ko/reference/default-theme-search.md     |    2 +-
 docs/ko/reference/runtime-api.md              |    2 +-
 docs/pt/reference/default-theme-search.md     |    2 +-
 docs/pt/reference/runtime-api.md              |    2 +-
 docs/ru/reference/default-theme-search.md     |    2 +-
 docs/zh/reference/default-theme-search.md     |    2 +-
 33 files changed, 1628 insertions(+), 1638 deletions(-)

diff --git a/docs/en/reference/default-theme-search.md b/docs/en/reference/default-theme-search.md
index 8221bb4a..d9e00a1d 100644
--- a/docs/en/reference/default-theme-search.md
+++ b/docs/en/reference/default-theme-search.md
@@ -179,7 +179,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/en/reference/runtime-api.md b/docs/en/reference/runtime-api.md
index d55165f5..ca1f3987 100644
--- a/docs/en/reference/runtime-api.md
+++ b/docs/en/reference/runtime-api.md
@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/es/reference/default-theme-search.md b/docs/es/reference/default-theme-search.md
index 986a3a40..e2034ba2 100644
--- a/docs/es/reference/default-theme-search.md
+++ b/docs/es/reference/default-theme-search.md
@@ -174,7 +174,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/es/reference/runtime-api.md b/docs/es/reference/runtime-api.md
index 1446df4c..012e8d7c 100644
--- a/docs/es/reference/runtime-api.md
+++ b/docs/es/reference/runtime-api.md
@@ -45,7 +45,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/fa/reference/default-theme-search.md b/docs/fa/reference/default-theme-search.md
index 256c2378..dad447fa 100644
--- a/docs/fa/reference/default-theme-search.md
+++ b/docs/fa/reference/default-theme-search.md
@@ -174,7 +174,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/fa/reference/runtime-api.md b/docs/fa/reference/runtime-api.md
index 67e076cd..ba74ff18 100644
--- a/docs/fa/reference/runtime-api.md
+++ b/docs/fa/reference/runtime-api.md
@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/ja/guide/cms.md b/docs/ja/guide/cms.md
index 191312df..9e3ceb06 100644
--- a/docs/ja/guide/cms.md
+++ b/docs/ja/guide/cms.md
@@ -12,44 +12,44 @@ CMS ごとに動作が異なるため、ここでは各自の環境に合わせ
 
 1. CMS が認証を必要とする場合は、API トークンを格納するための `.env` を作成し、次のように読み込みます。
 
-    ```js
-    // posts/[id].paths.js
-    import { loadEnv } from 'vitepress'
+   ```js
+   // posts/[id].paths.js
+   import { loadEnv } from 'vitepress'
 
-    const env = loadEnv('', process.cwd())
-    ```
+   const env = loadEnv('', process.cwd())
+   ```
 
 2. CMS から必要なデータを取得し、適切なパスデータの形式に整形します。
 
-    ```js
-    export default {
-      async paths() {
-        // 必要に応じて各 CMS のクライアントライブラリを使用
-        const data = await (await fetch('https://my-cms-api', {
-          headers: {
-            // 必要ならトークン
-          }
-        })).json()
-
-        return data.map(entry => {
-          return {
-            params: { id: entry.id, /* title, authors, date など */ },
-            content: entry.content
-          }
-        })
-      }
-    }
-    ```
+   ```js
+   export default {
+     async paths() {
+       // 必要に応じて各 CMS のクライアントライブラリを使用
+       const data = await (await fetch('https://my-cms-api', {
+         headers: {
+           // 必要ならトークン
+         }
+       })).json()
+
+       return data.map((entry) => {
+         return {
+           params: { id: entry.id, /* title, authors, date など */ },
+           content: entry.content
+         }
+       })
+     }
+   }
+   ```
 
 3. ページ内でコンテンツをレンダリングします。
 
-    ```md
-    # {{ $params.title }}
+   ```md
+   # {{ $params.title }}
 
-    - {{ $params.date }} に {{ $params.author }} が作成
+   - {{ $params.date }} に {{ $params.author }} が作成
 
-    <!-- @content -->
-    ```
+   <!-- @content -->
+   ```
 
 ## 連携ガイドの募集 {#integration-guides}
 
diff --git a/docs/ja/guide/custom-theme.md b/docs/ja/guide/custom-theme.md
index 0095ca8a..9f11bba0 100644
--- a/docs/ja/guide/custom-theme.md
+++ b/docs/ja/guide/custom-theme.md
@@ -23,43 +23,42 @@ VitePress のカスタムテーマは次のインターフェースを持つオ
 
 ```ts
 interface Theme {
-/**
-  * すべてのページに適用されるルートレイアウトコンポーネント
-  * @required
-  */
-Layout: Component
-/**
-  * Vue アプリインスタンスを拡張
-  * @optional
-  */
-enhanceApp?: (ctx: EnhanceAppContext) => Awaitable<void>
-/**
-  * 別のテーマを拡張し、そのテーマの `enhanceApp` を先に実行
-  * @optional
-  */
-extends?: Theme
+  /**
+   * すべてのページに適用されるルートレイアウトコンポーネント
+   * @required
+   */
+  Layout: Component
+  /**
+   * Vue アプリインスタンスを拡張
+   * @optional
+   */
+  enhanceApp?: (ctx: EnhanceAppContext) => Awaitable<void>
+  /**
+   * 別のテーマを拡張し、そのテーマの `enhanceApp` を先に実行
+   * @optional
+   */
+  extends?: Theme
 }
 
 interface EnhanceAppContext {
-app: App // Vue アプリインスタンス
-router: Router // VitePress のルーターインスタンス
-siteData: Ref<SiteData> // サイト全体のメタデータ
+  app: App // Vue アプリインスタンス
+  router: Router // VitePress のルーターインスタンス
+  siteData: Ref<SiteData> // サイト全体のメタデータ
 }
 ```
 
 テーマエントリファイルでは、このテーマをデフォルトエクスポートとして公開します。
 
 ```js [.vitepress/theme/index.js]
-
 // テーマエントリでは Vue ファイルを直接インポートできます
 // VitePress は @vitejs/plugin-vue をあらかじめ設定済みです
 import Layout from './Layout.vue'
 
 export default {
-Layout,
-enhanceApp({ app, router, siteData }) {
-  // ...
-}
+  Layout,
+  enhanceApp({ app, router, siteData }) {
+    // ...
+  }
 }
 ```
 
@@ -73,10 +72,10 @@ enhanceApp({ app, router, siteData }) {
 
 ```vue [.vitepress/theme/Layout.vue]
 <template>
-<h1>Custom Layout!</h1>
+  <h1>Custom Layout!</h1>
 
-<!-- この部分に markdown コンテンツが描画されます -->
-<Content />
+  <!-- この部分に markdown コンテンツが描画されます -->
+  <Content />
 </template>
 ```
 
@@ -100,11 +99,11 @@ const { page } = useData()
 
 [`useData()`](../reference/runtime-api#usedata) ヘルパーを使うと、条件によってレイアウトを切り替えるために必要なすべてのランタイムデータを取得できます。アクセスできるデータのひとつにフロントマターがあります。これを利用すると、ページごとにレイアウトを制御できます。例えば、ユーザーが特別なホームページレイアウトを使いたい場合は以下のように記述します。
 
- ```md
+```md
 ---
 layout: home
 ---
- ```
+```
 
 テーマ側を次のように調整します。
 
@@ -164,7 +163,6 @@ npm パッケージとして配布する場合は、次の手順を踏みます
 
 ## カスタムテーマの利用 {#consuming-a-custom-theme}
 
-
 外部テーマを利用するには、カスタムテーマエントリからインポートして再エクスポートします。
 
 ```js [.vitepress/theme/index.js]
@@ -179,10 +177,10 @@ export default Theme
 import Theme from 'awesome-vitepress-theme'
 
 export default {
-extends: Theme,
-enhanceApp(ctx) {
-  // ...
-}
+  extends: Theme,
+  enhanceApp(ctx) {
+    // ...
+  }
 }
 ```
 
@@ -192,8 +190,8 @@ enhanceApp(ctx) {
 import baseConfig from 'awesome-vitepress-theme/config'
 
 export default {
-// 必要に応じてテーマの基本設定を拡張
-extends: baseConfig
+  // 必要に応じてテーマの基本設定を拡張
+  extends: baseConfig
 }
 ```
 
@@ -205,9 +203,9 @@ import { defineConfigWithTheme } from 'vitepress'
 import type { ThemeConfig } from 'awesome-vitepress-theme'
 
 export default defineConfigWithTheme<ThemeConfig>({
-extends: baseConfig,
-themeConfig: {
-  // 型は `ThemeConfig`
-}
+  extends: baseConfig,
+  themeConfig: {
+    // 型は `ThemeConfig`
+  }
 })
 ```
diff --git a/docs/ja/guide/data-loading.md b/docs/ja/guide/data-loading.md
index 469999d7..def21ad6 100644
--- a/docs/ja/guide/data-loading.md
+++ b/docs/ja/guide/data-loading.md
@@ -10,12 +10,12 @@ VitePress には **データローダー (data loaders)** という機能があ
 
 ```js [example.data.js]
 export default {
-load() {
-  return {
-    hello: 'world'
+  load() {
+    return {
+      hello: 'world'
+    }
   }
 }
-}
 ```
 
 ローダーモジュールは Node.js 上でのみ評価されるため、Node API や npm 依存関係を自由に利用できます。
@@ -179,7 +179,6 @@ interface ContentOptions<T = ContentData[]> {
 
 ## 型付きデータローダー {#typed-data-loaders}
 
-
 TypeScript を使用する場合は、ローダーと `data` エクスポートを型付けできます。
 
 ```ts
@@ -202,7 +201,6 @@ export default defineLoader({
 
 ## 設定情報の取得 {#configuration}
 
-
 ローダー内で設定情報を取得するには次のようにします。
 
 ```ts
diff --git a/docs/ja/guide/deploy.md b/docs/ja/guide/deploy.md
index b709c4d6..b3415105 100644
--- a/docs/ja/guide/deploy.md
+++ b/docs/ja/guide/deploy.md
@@ -4,7 +4,6 @@ outline: deep
 
 # VitePress サイトをデプロイする {#deploy-your-vitepress-site}
 
-
 以下のガイドは、次の前提に基づいています。
 
 - VitePress のサイトはプロジェクトの `docs` ディレクトリ内にある。
@@ -12,17 +11,16 @@ outline: deep
 - VitePress はプロジェクトのローカル依存としてインストールされており、`package.json` に次のスクリプトが設定されている。
 
 ```json [package.json]
- {
-   "scripts": {
-     "docs:build": "vitepress build docs",
-     "docs:preview": "vitepress preview docs"
-   }
- }
+{
+  "scripts": {
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  }
+}
 ```
 
 ## ローカルでビルドしてテストする {#build-and-test-locally}
 
-
 1. 次のコマンドでドキュメントをビルドします。
 
    ```sh
@@ -35,30 +33,28 @@ outline: deep
     $ npm run docs:preview
    ```
 
-    `preview` コマンドはローカルの静的 Web サーバーを起動し、出力ディレクトリ `.vitepress/dist` を `http://localhost:4173` で配信します。プロダクションへプッシュする前に見た目を確認できます。
+   `preview` コマンドはローカルの静的 Web サーバーを起動し、出力ディレクトリ `.vitepress/dist` を `http://localhost:4173` で配信します。プロダクションへプッシュする前に見た目を確認できます。
 
 3. `--port` 引数でサーバーのポートを設定できます。
 
    ```json
-    {
-      "scripts": {
-        "docs:preview": "vitepress preview docs --port 8080"
-      }
-    }
+   {
+     "scripts": {
+       "docs:preview": "vitepress preview docs --port 8080"
+     }
+   }
    ```
 
-    これで `docs:preview` は `http://localhost:8080` でサーバーを起動します。
+   これで `docs:preview` は `http://localhost:8080` でサーバーを起動します。
 
 ## 公開ベースパスの設定 {#setting-a-public-base-path}
 
-
 デフォルトでは、サイトはドメインのルートパス（`/`）にデプロイされることを想定しています。サイトをサブパス、例：`https://mywebsite.com/blog/` で配信する場合は、VitePress の設定で [`base`](../reference/site-config#base) オプションを `'/blog/'` に設定してください。
 
 **例:** GitHub（または GitLab）Pages に `user.github.io/repo/` としてデプロイするなら、`base` を `/repo/` に設定します。
 
 ## HTTP キャッシュヘッダー {#http-cache-headers}
 
-
 本番サーバーの HTTP ヘッダーを制御できる場合は、`cache-control` ヘッダーを設定して、再訪時のパフォーマンスを向上させましょう。
 
 本番ビルドでは静的アセット（JavaScript、CSS、`public` 以外のインポートアセット）にハッシュ付きファイル名が使用されます。ブラウザの開発者ツールのネットワークタブで本番プレビューを確認すると、`app.4f283b18.js` のようなファイルが見られます。
@@ -86,19 +82,19 @@ Cache-Control: max-age=31536000,immutable
 ::: details `vercel.json` による Vercel 設定例
 
 ```json
- {
-   "headers": [
-     {
-       "source": "/assets/(.*)",
-       "headers": [
-         {
-           "key": "Cache-Control",
-           "value": "max-age=31536000, immutable"
-         }
-       ]
-     }
-   ]
- }
+{
+  "headers": [
+    {
+      "source": "/assets/(.*)",
+      "headers": [
+        {
+          "key": "Cache-Control",
+          "value": "max-age=31536000, immutable"
+        }
+      ]
+    }
+  ]
+}
 ```
 
 注：`vercel.json` は **リポジトリのルート** に配置してください。
@@ -109,7 +105,6 @@ Cache-Control: max-age=31536000,immutable
 
 ## プラットフォーム別ガイド {#platform-guides}
 
-
 ### Netlify / Vercel / Cloudflare Pages / AWS Amplify / Render {#netlify-vercel-cloudflare-pages-aws-amplify-render}
 
 新しいプロジェクトを作成し、ダッシュボードで次の設定に変更します。
@@ -127,77 +122,77 @@ HTML の _Auto Minify_ のようなオプションを有効にしないでくだ
 1. プロジェクトの `.github/workflows` ディレクトリに `deploy.yml` を作成し、以下の内容を記述します。
 
    ```yaml [.github/workflows/deploy.yml]
-    # Sample workflow for building and deploying a VitePress site to GitHub Pages
-    #
-    name: Deploy VitePress site to Pages
-
-    on:
-      # Runs on pushes targeting the `main` branch. Change this to `master` if you're
-      # using the `master` branch as the default branch.
-      push:
-        branches: [main]
-
-      # Allows you to run this workflow manually from the Actions tab
-      workflow_dispatch:
-
-    # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-    permissions:
-      contents: read
-      pages: write
-      id-token: write
-
-    # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-    # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
-    concurrency:
-      group: pages
-      cancel-in-progress: false
-
-    jobs:
-      # Build job
-      build:
-        runs-on: ubuntu-latest
-        steps:
-          - name: Checkout
-            uses: actions/checkout@v5
-            with:
-              fetch-depth: 0 # Not needed if lastUpdated is not enabled
-          # - uses: pnpm/action-setup@v4 # Uncomment this block if you're using pnpm
-          #   with:
-          #     version: 9 # Not needed if you've set "packageManager" in package.json
-          # - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
-          - name: Setup Node
-            uses: actions/setup-node@v6
-            with:
-              node-version: 24
-              cache: npm # or pnpm / yarn
-          - name: Setup Pages
-            uses: actions/configure-pages@v4
-          - name: Install dependencies
-            run: npm ci # or pnpm install / yarn install / bun install
-          - name: Build with VitePress
-            run: npm run docs:build # or pnpm docs:build / yarn docs:build / bun run docs:build
-          - name: Upload artifact
-            uses: actions/upload-pages-artifact@v3
-            with:
-              path: docs/.vitepress/dist
-
-      # Deployment job
-      deploy:
-        environment:
-          name: github-pages
-          url: ${{ steps.deployment.outputs.page_url }}
-        needs: build
-        runs-on: ubuntu-latest
-        name: Deploy
-        steps:
-          - name: Deploy to GitHub Pages
-            id: deployment
-            uses: actions/deploy-pages@v4
+   # Sample workflow for building and deploying a VitePress site to GitHub Pages
+   #
+   name: Deploy VitePress site to Pages
+
+   on:
+     # Runs on pushes targeting the `main` branch. Change this to `master` if you're
+     # using the `master` branch as the default branch.
+     push:
+       branches: [main]
+
+     # Allows you to run this workflow manually from the Actions tab
+     workflow_dispatch:
+
+   # Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+   permissions:
+     contents: read
+     pages: write
+     id-token: write
+
+   # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+   # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+   concurrency:
+     group: pages
+     cancel-in-progress: false
+
+   jobs:
+     # Build job
+     build:
+       runs-on: ubuntu-latest
+       steps:
+         - name: Checkout
+           uses: actions/checkout@v5
+           with:
+             fetch-depth: 0 # Not needed if lastUpdated is not enabled
+         # - uses: pnpm/action-setup@v4 # Uncomment this block if you're using pnpm
+         #   with:
+         #     version: 9 # Not needed if you've set "packageManager" in package.json
+         # - uses: oven-sh/setup-bun@v1 # Uncomment this if you're using Bun
+         - name: Setup Node
+           uses: actions/setup-node@v6
+           with:
+             node-version: 24
+             cache: npm # or pnpm / yarn
+         - name: Setup Pages
+           uses: actions/configure-pages@v4
+         - name: Install dependencies
+           run: npm ci # or pnpm install / yarn install / bun install
+         - name: Build with VitePress
+           run: npm run docs:build # or pnpm docs:build / yarn docs:build / bun run docs:build
+         - name: Upload artifact
+           uses: actions/upload-pages-artifact@v3
+           with:
+             path: docs/.vitepress/dist
+
+     # Deployment job
+     deploy:
+       environment:
+         name: github-pages
+         url: ${{ steps.deployment.outputs.page_url }}
+       needs: build
+       runs-on: ubuntu-latest
+       name: Deploy
+       steps:
+         - name: Deploy to GitHub Pages
+           id: deployment
+           uses: actions/deploy-pages@v4
    ```
 
-    ::: warning
-    VitePress の `base` オプションが正しく設定されていることを確認してください。詳細は [公開ベースパスの設定](#公開ベースパスの設定) を参照してください。
-    :::
+   ::: warning
+   VitePress の `base` オプションが正しく設定されていることを確認してください。詳細は [公開ベースパスの設定](#公開ベースパスの設定) を参照してください。
+   :::
 
 2. リポジトリ設定の「Pages」メニューで、「Build and deployment > Source」を「GitHub Actions」に設定します。
 
@@ -210,20 +205,20 @@ HTML の _Auto Minify_ のようなオプションを有効にしないでくだ
 2. プロジェクトのルートに `.gitlab-ci.yml` を作成して、以下を追加します。これにより、コンテンツを更新するたびにサイトがビルド・デプロイされます。
 
    ```yaml [.gitlab-ci.yml]
-    image: node:18
-    pages:
-      cache:
-        paths:
-          - node_modules/
-      script:
-        # - apk add git # Uncomment this if you're using small docker images like alpine and have lastUpdated enabled
-        - npm install
-        - npm run docs:build
-      artifacts:
-        paths:
-          - public
-      only:
-        - main
+   image: node:18
+   pages:
+     cache:
+       paths:
+         - node_modules/
+     script:
+       # - apk add git # Uncomment this if you're using small docker images like alpine and have lastUpdated enabled
+       - npm install
+       - npm run docs:build
+     artifacts:
+       paths:
+         - public
+     only:
+       - main
    ```
 
 ### Azure Static Web Apps {#azure-static-web-apps}
@@ -231,7 +226,6 @@ HTML の _Auto Minify_ のようなオプションを有効にしないでくだ
 1. [公式ドキュメント](https://docs.microsoft.com/en-us/azure/static-web-apps/build-configuration) に従います。
 
 2. 設定ファイルで次の値を指定します（`api_location` のように不要なものは削除）。
-
    - **`app_location`**: `/`
    - **`output_location`**: `docs/.vitepress/dist`
    - **`app_build_command`**: `npm run docs:build`
@@ -243,22 +237,22 @@ HTML の _Auto Minify_ のようなオプションを有効にしないでくだ
    `firebase.json`:
 
    ```json [firebase.json]
-    {
-      "hosting": {
-        "public": "docs/.vitepress/dist",
-        "ignore": []
-      }
-    }
+   {
+     "hosting": {
+       "public": "docs/.vitepress/dist",
+       "ignore": []
+     }
+   }
    ```
 
    `.firebaserc`:
 
    ```json [.firebaserc]
-    {
-      "projects": {
-        "default": "<YOUR_FIREBASE_ID>"
-      }
-    }
+   {
+     "projects": {
+       "default": "<YOUR_FIREBASE_ID>"
+     }
+   }
    ```
 
 2. `npm run docs:build` の後、次のコマンドでデプロイします。
@@ -282,9 +276,9 @@ HTML の _Auto Minify_ のようなオプションを有効にしないでくだ
 2. プロジェクトのルートに `static.json` を作成し、以下を記述します。
 
    ```json [static.json]
-    {
-      "root": "docs/.vitepress/dist"
-    }
+   {
+     "root": "docs/.vitepress/dist"
+   }
    ```
 
 ### Edgio {#edgio}
diff --git a/docs/ja/guide/extending-default-theme.md b/docs/ja/guide/extending-default-theme.md
index 6047ac91..fc5ce184 100644
--- a/docs/ja/guide/extending-default-theme.md
+++ b/docs/ja/guide/extending-default-theme.md
@@ -70,7 +70,9 @@ export default DefaultTheme
 export default {
   transformHead({ assets }) {
     // 使うフォントに合わせて正規表現を調整
-    const myFontFile = assets.find(file => /font-name\.[\w-]+\.woff2/.test(file))
+    const myFontFile = assets.find((file) =>
+      /font-name\.[\w-]+\.woff2/.test(file)
+    )
     if (myFontFile) {
       return [
         [
diff --git a/docs/ja/guide/frontmatter.md b/docs/ja/guide/frontmatter.md
index 0c5ddcb5..46c52e85 100644
--- a/docs/ja/guide/frontmatter.md
+++ b/docs/ja/guide/frontmatter.md
@@ -5,10 +5,10 @@
 VitePress はすべての Markdown ファイルで YAML フロントマターをサポートしており、[gray-matter](https://github.com/jonschlinkert/gray-matter) で解析します。フロントマターは Markdown ファイルの先頭（`<script>` タグを含むあらゆる要素より前）に配置し、三本のハイフンで囲まれた **有効な YAML** 形式で記述します。例:
 
 ```md
- ---
- title: Docs with VitePress
- editLink: true
- ---
+---
+title: Docs with VitePress
+editLink: true
+---
 ```
 
 サイトやデフォルトテーマの多くの設定オプションには、フロントマター上で対応するオプションがあります。フロントマターを使うことで、**そのページに限って** 特定の振る舞いを上書きできます。詳細は [Frontmatter Config Reference](../reference/frontmatter-config) を参照してください。
@@ -22,14 +22,14 @@ VitePress はすべての Markdown ファイルで YAML フロントマターを
 Markdown ファイル内での使用例:
 
 ```md
- ---
- title: Docs with VitePress
- editLink: true
- ---
+---
+title: Docs with VitePress
+editLink: true
+---
 
- # {{ $frontmatter.title }}
+# {{ $frontmatter.title }}
 
- Guide content
+Guide content
 ```
 
 [`useData()`](../reference/runtime-api#usedata) ヘルパーを使えば、`<script setup>` 内からも現在のページのフロントマターデータにアクセスできます。
@@ -38,11 +38,11 @@ Markdown ファイル内での使用例:
 
 VitePress は JSON フロントマター構文もサポートしています。中括弧で開始・終了する形式です。
 
-```json
- ---
- {
-   "title": "Blogging Like a Hacker",
-   "editLink": true
- }
- ---
+```md
+---
+{
+  "title": "Blogging Like a Hacker",
+  "editLink": true
+}
+---
 ```
diff --git a/docs/ja/guide/getting-started.md b/docs/ja/guide/getting-started.md
index 345beeba..91690aae 100644
--- a/docs/ja/guide/getting-started.md
+++ b/docs/ja/guide/getting-started.md
@@ -10,7 +10,7 @@
 
 - [Node.js](https://nodejs.org/) バージョン 18 以上
 - VitePress をコマンドラインインターフェース (CLI) で操作するためのターミナル
-- [Markdown](https://en.wikipedia.org/wiki/Markdown) 構文に対応したテキストエディタ  
+- [Markdown](https://en.wikipedia.org/wiki/Markdown) 構文に対応したテキストエディタ
   - 推奨: [VSCode](https://code.visualstudio.com/) と [公式 Vue 拡張](https://marketplace.visualstudio.com/items?itemName=Vue.volar)
 
 VitePress は単独でも利用できますし、既存プロジェクトに組み込むことも可能です。いずれの場合も以下でインストールできます。
diff --git a/docs/ja/guide/markdown.md b/docs/ja/guide/markdown.md
index 682d0a65..97b7c2db 100644
--- a/docs/ja/guide/markdown.md
+++ b/docs/ja/guide/markdown.md
@@ -10,9 +10,9 @@ VitePress には組み込みの Markdown 拡張機能が用意されています
 
 自動生成ではなく任意のアンカーを指定したい場合は、見出しの末尾にサフィックスを追加します。
 
- ```md
- # カスタムアンカーを使う {#my-anchor}
- ```
+```md
+# カスタムアンカーを使う {#my-anchor}
+```
 
 これにより、デフォルトの `#using-custom-anchors` ではなく `#my-anchor` でその見出しにリンクできます。
 
@@ -26,29 +26,29 @@ VitePress には組み込みの Markdown 拡張機能が用意されています
 
 次のようなディレクトリ構成があるとします。
 
- ```
- .
- ├─ index.md
- ├─ foo
- │  ├─ index.md
- │  ├─ one.md
- │  └─ two.md
- └─ bar
-    ├─ index.md
-    ├─ three.md
-    └─ four.md
- ```
+```
+.
+├─ index.md
+├─ foo
+│  ├─ index.md
+│  ├─ one.md
+│  └─ two.md
+└─ bar
+   ├─ index.md
+   ├─ three.md
+   └─ four.md
+```
 
 そして、現在編集中のファイルが `foo/one.md` の場合:
 
- ```md
- [Home](/) <!-- ルートの index.md に移動 -->
- [foo](/foo/) <!-- ディレクトリ foo の index.html に移動 -->
- [foo の見出し](./#heading) <!-- foo の index ファイル内の見出しへアンカー -->
- [bar - three](../bar/three) <!-- 拡張子は省略可能 -->
- [bar - three](../bar/three.md) <!-- .md を付けても OK -->
- [bar - four](../bar/four.html) <!-- .html を付けても OK -->
- ```
+```md
+[Home](/) <!-- ルートの index.md に移動 -->
+[foo](/foo/) <!-- ディレクトリ foo の index.html に移動 -->
+[foo の見出し](./#heading) <!-- foo の index ファイル内の見出しへアンカー -->
+[bar - three](../bar/three) <!-- 拡張子は省略可能 -->
+[bar - three](../bar/three.md) <!-- .md を付けても OK -->
+[bar - four](../bar/four.html) <!-- .html を付けても OK -->
+```
 
 ### ページサフィックス {#page-suffix}
 
@@ -65,12 +65,12 @@ VitePress には組み込みの Markdown 拡張機能が用意されています
 
 [YAML フロントマター](https://jekyllrb.com/docs/front-matter/) をそのままサポートしています。
 
- ```yaml
- ---
- title: ハッカーのようにブログを書く
- lang: ja-JP
- ---
- ```
+```yaml
+---
+title: ハッカーのようにブログを書く
+lang: ja-JP
+---
+```
 
 このデータはページ内や、カスタム／テーマコンポーネントからも利用できます。詳しくは [Frontmatter](../reference/frontmatter-config) を参照してください。
 
@@ -78,29 +78,29 @@ VitePress には組み込みの Markdown 拡張機能が用意されています
 
 **入力**
 
- ```md
- | テーブル       |   は        |  クール |
- | -------------- | :---------: | ------: |
- | 3列目は        | 右寄せ      |  $1600 |
- | 2列目は        |   中央      |    $12 |
- | シマ模様       |  neat です  |     $1 |
- ```
+```md
+| テーブル |    は     | クール |
+| -------- | :-------: | -----: |
+| 3列目は  |  右寄せ   |  $1600 |
+| 2列目は  |   中央    |    $12 |
+| シマ模様 | neat です |     $1 |
+```
 
 **出力**
 
-| テーブル |   は   |  クール |
-| -------- | :----: | ------: |
-| 3列目は  | 右寄せ |  \$1600 |
-| 2列目は  |  中央  |    \$12 |
-| シマ模様 | neatです |     \$1 |
+| テーブル |    は    | クール |
+| -------- | :------: | -----: |
+| 3列目は  |  右寄せ  | \$1600 |
+| 2列目は  |   中央   |   \$12 |
+| シマ模様 | neatです |    \$1 |
 
 ## 絵文字 :tada: {#emoji}
 
 **入力**
 
- ```
- :tada: :100:
- ```
+```
+:tada: :100:
+```
 
 **出力**
 
@@ -112,9 +112,9 @@ VitePress には組み込みの Markdown 拡張機能が用意されています
 
 **入力**
 
- ```
- [[toc]]
- ```
+```
+[[toc]]
+```
 
 **出力**
 
@@ -130,27 +130,27 @@ TOC のレンダリングは `markdown.toc` オプションで設定できます
 
 **入力**
 
- ```md
- ::: info
- これは情報ボックスです。
- :::
+```md
+::: info
+これは情報ボックスです。
+:::
 
- ::: tip
- これはヒントです。
- :::
+::: tip
+これはヒントです。
+:::
 
- ::: warning
- これは警告です。
- :::
+::: warning
+これは警告です。
+:::
 
- ::: danger
- これは危険の警告です。
- :::
+::: danger
+これは危険の警告です。
+:::
 
- ::: details
- これは詳細ブロックです。
- :::
- ```
+::: details
+これは詳細ブロックです。
+:::
+```
 
 **出力**
 
@@ -180,17 +180,17 @@ TOC のレンダリングは `markdown.toc` オプションで設定できます
 
 **入力**
 
- ````md
- ::: danger 停止
- 危険地帯。先に進まないでください。
- :::
+````md
+::: danger 停止
+危険地帯。先に進まないでください。
+:::
 
- ::: details クリックしてコードを表示/非表示
- ```js
- console.log('こんにちは、VitePress!')
- ```
- :::
- ````
+::: details クリックしてコードを表示/非表示
+```js
+console.log('こんにちは、VitePress!')
+```
+:::
+````
 
 **出力**
 
@@ -199,29 +199,29 @@ TOC のレンダリングは `markdown.toc` オプションで設定できます
 :::
 
 ::: details クリックしてコードを表示/非表示
- ```js
- console.log('こんにちは、VitePress!')
- ```
+```js
+console.log('こんにちは、VitePress!')
+```
 :::
 
 また、英語以外で執筆する場合などは、サイト設定に以下を追加してタイトル文字列をグローバルに上書きできます。
 
- ```ts
- // config.ts
- export default defineConfig({
-   // ...
-   markdown: {
-     container: {
-       tipLabel: 'ヒント',
-       warningLabel: '警告',
-       dangerLabel: '危険',
-       infoLabel: '情報',
-       detailsLabel: '詳細'
-     }
-   }
- // ...
- })
- ```
+```ts
+// config.ts
+export default defineConfig({
+  // ...
+  markdown: {
+    container: {
+      tipLabel: 'ヒント',
+      warningLabel: '警告',
+      dangerLabel: '危険',
+      infoLabel: '情報',
+      detailsLabel: '詳細'
+    }
+  }
+  // ...
+})
+```
 
 ### 追加属性 {#additional-attributes}
 
@@ -229,20 +229,20 @@ TOC のレンダリングは `markdown.toc` オプションで設定できます
 
 **入力**
 
- ````md
- ::: details クリックしてコードを表示/非表示 {open}
- ```js
- console.log('こんにちは、VitePress!')
- ```
- :::
- ````
+````md
+::: details クリックしてコードを表示/非表示 {open}
+```js
+console.log('こんにちは、VitePress!')
+```
+:::
+````
 
 **出力**
 
 ::: details クリックしてコードを表示/非表示 {open}
- ```js
- console.log('こんにちは、VitePress!')
- ```
+```js
+console.log('こんにちは、VitePress!')
+```
 :::
 
 ### `raw`
@@ -251,11 +251,11 @@ TOC のレンダリングは `markdown.toc` オプションで設定できます
 
 **構文**
 
- ```md
- ::: raw
- Wraps in a `<div class="vp-raw">`
- :::
- ```
+```md
+::: raw
+Wraps in a `<div class="vp-raw">`
+:::
+```
 
 `vp-raw` クラスは要素に直接付与することも可能です。スタイルの分離は現在オプトインです。
 
@@ -289,43 +289,39 @@ VitePress は [GitHub 形式のアラート](https://docs.github.com/en/get-star
 
 **入力**
 
+```md
+> [!NOTE]
+> 流し読みでも目に留めてほしい情報を強調します。
 
- ```md
- > [!NOTE]
- > 流し読みでも目に留めてほしい情報を強調します。
-
- > [!TIP]
- > 成功の手助けとなる任意の情報です。
+> [!TIP]
+> 成功の手助けとなる任意の情報です。
 
- > [!IMPORTANT]
- > 成功に必須の重要情報です。
+> [!IMPORTANT]
+> 成功に必須の重要情報です。
 
- > [!WARNING]
- > 危険性があるため即時の注意が必要な重要情報です。
-
- > [!CAUTION]
- > 行動による望ましくない結果の可能性です。
+> [!WARNING]
+> 危険性があるため即時の注意が必要な重要情報です。
 
+> [!CAUTION]
+> 行動による望ましくない結果の可能性です。
 ```
 
 **出力**
 
+> [!NOTE]
+> 流し読みでも目に留めてほしい情報を強調します。
 
- > [!NOTE]
- > 流し読みでも目に留めてほしい情報を強調します。
-
- > [!TIP]
- > 成功の手助けとなる任意の情報です。
+> [!TIP]
+> 成功の手助けとなる任意の情報です。
 
- > [!IMPORTANT]
- > 成功に必須の重要情報です。
+> [!IMPORTANT]
+> 成功に必須の重要情報です。
 
- > [!WARNING]
- > 危険性があるため即時の注意が必要な重要情報です。
-
- > [!CAUTION]
- > 行動による望ましくない結果の可能性です。
+> [!WARNING]
+> 危険性があるため即時の注意が必要な重要情報です。
 
+> [!CAUTION]
+> 行動による望ましくない結果の可能性です。
 
 ## コードブロックのシンタックスハイライト {#syntax-highlighting-in-code-blocks}
 
@@ -333,39 +329,41 @@ VitePress は [Shiki](https://github.com/shikijs/shiki) を使って、Markdown
 
 **入力**
 
- ````
-  ```js
-  export default {
-    name: 'MyComponent',
-    // ...
-  }
-  ```
+````md
+```js
+export default {
+  name: 'MyComponent',
+  // ...
+}
+```
+````
+
+````md
+```html
+<ul>
+  <li v-for="todo in todos" :key="todo.id">
+    {{ todo.text }}
+  </li>
+</ul>
+```
 ````
-  ````
-  ```html
- <ul>
-   <li v-for="todo in todos" :key="todo.id">
-     {{ todo.text }}
-   </li>
- </ul>
- ```
- ````
 
 **出力**
 
-  ```js
-  export default {
-    name: 'MyComponent',
-    // ...
-  }
-  ```
-  ```html
- <ul>
-   <li v-for="todo in todos" :key="todo.id">
-     {{ todo.text }}
-   </li>
- </ul>
- ```
+```js
+export default {
+  name: 'MyComponent',
+  // ...
+}
+```
+
+```html
+<ul>
+  <li v-for="todo in todos" :key="todo.id">
+    {{ todo.text }}
+  </li>
+</ul>
+```
 
 有効な言語の [一覧](https://shiki.style/languages) は Shiki のリポジトリで確認できます。
 
@@ -375,29 +373,29 @@ VitePress は [Shiki](https://github.com/shikijs/shiki) を使って、Markdown
 
 **入力**
 
- ````
-  ```js{4}
-  export default {
-    data () {
-      return {
-        msg: 'ハイライト！'
-      }
+````md
+```js{4}
+export default {
+  data() {
+    return {
+      msg: 'ハイライト！'
     }
   }
-  ```
- ````
+}
+```
+````
 
 **出力**
 
-  ```js{4}
-  export default {
-    data () {
-      return {
-        msg: 'ハイライト！'
-      }
+```js{4}
+export default {
+  data() {
+    return {
+      msg: 'ハイライト！'
     }
   }
-  ```
+}
+```
 
 単一行だけでなく、複数の単一行や範囲、あるいはその組み合わせも指定できます:
 
@@ -407,66 +405,65 @@ VitePress は [Shiki](https://github.com/shikijs/shiki) を使って、Markdown
 
 **入力**
 
- ````
- ```js{1,4,6-8}
- export default { // Highlighted
-   data () {
-     return {
-       msg: `Highlighted!
-       This line isn't highlighted,
-       but this and the next 2 are.`,
-       motd: 'VitePress is awesome',
-       lorem: 'ipsum'
-     }
-   }
- }
- ```
- ````
+````md
+```js{1,4,6-8}
+export default { // Highlighted
+  data() {
+    return {
+      msg: `Highlighted!
+      This line isn't highlighted,
+      but this and the next 2 are.`,
+      motd: 'VitePress is awesome',
+      lorem: 'ipsum'
+    }
+  }
+}
+```
+````
 
 **出力**
 
-
- ```js{1,4,6-8}
- export default { // Highlighted
-   data () {
-     return {
-       msg: `Highlighted!
-       This line isn't highlighted,
-       but this and the next 2 are.`,
-       motd: 'VitePress is awesome',
-       lorem: 'ipsum'
-     }
-   }
- }
- ```
+```js{1,4,6-8}
+export default { // Highlighted
+  data() {
+    return {
+      msg: `Highlighted!
+      This line isn't highlighted,
+      but this and the next 2 are.`,
+      motd: 'VitePress is awesome',
+      lorem: 'ipsum'
+    }
+  }
+}
+```
 
 代替案として、`// [!code highlight]` コメントを使って行内を直接ハイライトできます。
 
 **入力**
 
- ```
- ```js
- export default {
-   data () {
-     return {
-       msg: 'ハイライト！' // [!code highlight]
-     }
-   }
- }
- ```
+````md
+```js
+export default {
+  data() {
+    return {
+      msg: 'ハイライト！' // [!code highlight]
+    }
+  }
+}
+```
+````
 
 **出力**
 
-
- ```js
- export default {
-   data () {
-     return {
-       msg: 'ハイライト！' // [!code highlight]
-     }
-   }
- }
- ```
+```js
+export default {
+  data() {
+    return {
+      msg: 'ハイライト！' // [!code highlight]
+    }
+  }
+}
+```
 
 ## コードブロックでのフォーカス {#focus-in-code-blocks}
 
@@ -476,17 +473,17 @@ VitePress は [Shiki](https://github.com/shikijs/shiki) を使って、Markdown
 
 **入力**
 
- ````
- ```js
- export default {
-   data () {
-     return {
-       msg: 'フォーカス！' // [!!code focus]
-     }
-   }
- }
- ```
- ````
+````md
+```js
+export default {
+  data() {
+    return {
+      msg: 'フォーカス！' // [!!code focus]
+    }
+  }
+}
+```
+````
 
 **出力**
 
@@ -506,24 +503,24 @@ export default {
 
 **入力**
 
- ````
- ```js
- export default {
-   data () {
-     return {
-       msg: 'Removed' // [!!code --]
-       msg: 'Added' // [!!code ++]
-     }
-   }
- }
- ```
- ````
+````md
+```js
+export default {
+  data() {
+    return {
+      msg: 'Removed' // [!!code --]
+      msg: 'Added' // [!!code ++]
+    }
+  }
+}
+```
+````
 
 **出力**
 
 ```js
 export default {
-  data () {
+  data() {
     return {
       msg: 'Removed' // [!code --]
       msg: 'Added' // [!code ++]
@@ -538,18 +535,18 @@ export default {
 
 **入力**
 
- ````
- ```js
- export default {
-   data () {
-     return {
-       msg: 'Error', // [!!code error]
-       msg: 'Warning' // [!!code warning]
-     }
-   }
- }
- ```
- ````
+````md
+```js
+export default {
+  data() {
+    return {
+      msg: 'Error', // [!!code error]
+      msg: 'Warning' // [!!code warning]
+    }
+  }
+}
+```
+````
 
 **出力**
 
@@ -568,13 +565,13 @@ export default {
 
 設定で、各コードブロックに行番号を表示できます：
 
- ```js
- export default {
-   markdown: {
-     lineNumbers: true
-   }
- }
- ```
+```js
+export default {
+  markdown: {
+    lineNumbers: true
+  }
+}
+```
 
 詳しくは [`markdown` オプション](../reference/site-config#markdown) を参照してください。
 
@@ -584,65 +581,65 @@ export default {
 
 **入力**
 
- ````
- ```ts {1}
- // 既定では line-numbers は無効
- const line2 = 'This is line 2'
- const line3 = 'This is line 3'
- ```
-
- ```ts:line-numbers {1}
- // line-numbers が有効
- const line2 = 'This is line 2'
- const line3 = 'This is line 3'
- ```
-
- ```ts:line-numbers=2 {1}
- // line-numbers が有効で、2 から開始
- const line3 = 'This is line 3'
- const line4 = 'This is line 4'
- ```
- ````
+````md
+```ts {1}
+// 既定では line-numbers は無効
+const line2 = 'This is line 2'
+const line3 = 'This is line 3'
+```
+
+```ts:line-numbers {1}
+// line-numbers が有効
+const line2 = 'This is line 2'
+const line3 = 'This is line 3'
+```
+
+```ts:line-numbers=2 {1}
+// line-numbers が有効で、2 から開始
+const line3 = 'This is line 3'
+const line4 = 'This is line 4'
+```
+````
 
 **出力**
 
- ```ts {1}
- // 既定では line-numbers は無効
- const line2 = 'This is line 2'
- const line3 = 'This is line 3'
- ```
+```ts {1}
+// 既定では line-numbers は無効
+const line2 = 'This is line 2'
+const line3 = 'This is line 3'
+```
 
- ```ts:line-numbers {1}
- // line-numbers が有効
- const line2 = 'This is line 2'
- const line3 = 'This is line 3'
- ```
+```ts:line-numbers {1}
+// line-numbers が有効
+const line2 = 'This is line 2'
+const line3 = 'This is line 3'
+```
 
- ```ts:line-numbers=2 {1}
- // line-numbers が有効で、2 から開始
- const line3 = 'This is line 3'
- const line4 = 'This is line 4'
- ```
+```ts:line-numbers=2 {1}
+// line-numbers が有効で、2 から開始
+const line3 = 'This is line 3'
+const line4 = 'This is line 4'
+```
 
 ## コードスニペットのインポート {#import-code-snippets}
 
 既存ファイルから、次の構文でコードスニペットをインポートできます：
 
- ```md
- <<< @/filepath
- ```
+```md
+<<< @/filepath
+```
 
 また、[行のハイライト](#line-highlighting-in-code-blocks)にも対応しています：
 
- ```md
- <<< @/filepath{highlightLines}
- ```
+```md
+<<< @/filepath{highlightLines}
+```
 
 **入力**
 
- ```md
- <<< @/snippets/snippet.js{2}
- ```
+```md
+<<< @/snippets/snippet.js{2}
+```
 
 **コードファイル**
 
@@ -655,18 +652,18 @@ export default {
 ::: tip
 `@` の値はソースルートを表します。既定では VitePress プロジェクトのルートですが、`srcDir` を設定している場合はその値になります。代替として、相対パスからのインポートも可能です：
 
- ```md
- <<< ../snippets/snippet.js
- ```
+```md
+<<< ../snippets/snippet.js
+```
 :::
 
 また、[VS Code のリージョン](https://code.visualstudio.com/docs/editor/codebasics#_folding)を利用して、コードファイルの該当部分のみを取り込むことができます。ファイルパスの後ろに `#` を付けてカスタムリージョン名を指定します：
 
 **入力**
 
- ```md
- <<< @/snippets/snippet-with-region.js#snippet{1}
- ```
+```md
+<<< @/snippets/snippet-with-region.js#snippet{1}
+```
 
 **コードファイル**
 
@@ -678,17 +675,17 @@ export default {
 
 中括弧（`{}`）の中で言語を指定することもできます：
 
- ```md
- <<< @/snippets/snippet.cs{c#}
+```md
+<<< @/snippets/snippet.cs{c#}
 
- <!-- 行のハイライト付き: -->
+<!-- 行のハイライト付き: -->
 
- <<< @/snippets/snippet.cs{1,2,4-6 c#}
+<<< @/snippets/snippet.cs{1,2,4-6 c#}
 
- <!-- 行番号付き: -->
+<!-- 行番号付き: -->
 
- <<< @/snippets/snippet.cs{1,2,4-6 c#:line-numbers}
- ```
+<<< @/snippets/snippet.cs{1,2,4-6 c#:line-numbers}
+```
 
 これは、ファイル拡張子からソース言語を推論できない場合に有用です。
 
@@ -698,78 +695,77 @@ export default {
 
 **入力**
 
- ````md
- ::: code-group
+````md
+::: code-group
 
- ```js [config.js]
- /**
-  * @type {import('vitepress').UserConfig}
-  */
- const config = {
-   // ...
- }
+```js [config.js]
+/**
+ * @type {import('vitepress').UserConfig}
+ */
+const config = {
+  // ...
+}
 
- export default config
- ```
+export default config
+```
 
- ```ts [config.ts]
- import type { UserConfig } from 'vitepress'
+```ts [config.ts]
+import type { UserConfig } from 'vitepress'
 
- const config: UserConfig = {
-   // ...
- }
+const config: UserConfig = {
+  // ...
+}
 
- export default config
- ```
+export default config
+```
 
- :::
- ````
+:::
+````
 
 **出力**
 
+::: code-group
 
- ::: code-group
-
- ```js [config.js]
- /**
-  * @type {import('vitepress').UserConfig}
-  */
- const config = {
-   // ...
- }
+```js [config.js]
+/**
+ * @type {import('vitepress').UserConfig}
+ */
+const config = {
+  // ...
+}
 
- export default config
- ```
+export default config
+```
 
- ```ts [config.ts]
- import type { UserConfig } from 'vitepress'
+```ts [config.ts]
+import type { UserConfig } from 'vitepress'
 
- const config: UserConfig = {
-   // ...
- }
+const config: UserConfig = {
+  // ...
+}
 
- export default config
- ```
+export default config
+```
 
- :::
+:::
 
 コードグループ内でも [スニペットのインポート](#import-code-snippets) が可能です：
 
 **入力**
 
- ```md
- ::: code-group
+```md
+::: code-group
 
- <!-- 既定ではファイル名がタイトルとして使われます -->
+<!-- 既定ではファイル名がタイトルとして使われます -->
 
- <<< @/snippets/snippet.js
+<<< @/snippets/snippet.js
 
- <!-- カスタムタイトルも指定できます -->
+<!-- カスタムタイトルも指定できます -->
 
- <<< @/snippets/snippet-with-region.js#snippet{1,2 ts:line-numbers} [リージョン付きスニペット]
+<<< @/snippets/snippet-with-region.js#snippet{1,2 ts:line-numbers} [リージョン付きスニペット]
 
- :::
- ```
+:::
+```
 
 **出力**
 
@@ -793,71 +789,71 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 **入力**
 
- ```md
- # ドキュメント
+```md
+# ドキュメント
 
- ## 基本
+## 基本
 
- <!--@include: ./parts/basics.md-->
- ```
+<!--@include: ./parts/basics.md-->
+```
 
 **パートファイル**（`parts/basics.md`）
 
- ```md
- はじめに知っておきたいこと。
+```md
+はじめに知っておきたいこと。
 
- ### 設定
+### 設定
 
- `.foorc.json` を使用して作成できます。
- ```
+`.foorc.json` を使用して作成できます。
+```
 
 **等価なコード**
 
- ```md
- # ドキュメント
+```md
+# ドキュメント
 
- ## 基本
+## 基本
 
- はじめに知っておきたいこと。
+はじめに知っておきたいこと。
 
- ### 設定
+### 設定
 
- `.foorc.json` を使用して作成できます。
- ```
+`.foorc.json` を使用して作成できます。
+```
 
 行範囲の選択にも対応しています。
 
 **入力**
 
- ```md:line-numbers
- # ドキュメント
+```md:line-numbers
+# ドキュメント
 
- ## 基本
+## 基本
 
- <!--@include: ./parts/basics.md{3,}-->
- ```
+<!--@include: ./parts/basics.md{3,}-->
+```
 
 **パートファイル**（`parts/basics.md`）
 
- ```md:line-numbers
- はじめに知っておきたいこと。
+```md:line-numbers
+はじめに知っておきたいこと。
 
- ### 設定
+### 設定
 
- `.foorc.json` を使って作成できます。
- ```
+`.foorc.json` を使って作成できます。
+```
 
 **等価なコード**
 
- ```md:line-numbers
- # ドキュメント
+```md:line-numbers
+# ドキュメント
 
- ## 基本
+## 基本
 
- ### 設定
+### 設定
 
- `.foorc.json` を使って作成できます。
- ```
+`.foorc.json` を使って作成できます。
+```
 
 選択できる行範囲の書式は、`{3,}`、`{,10}`、`{1,10}` のいずれかです。
 
@@ -865,38 +861,38 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 **入力**
 
- ```md:line-numbers
- # ドキュメント
+```md:line-numbers
+# ドキュメント
 
- ## 基本
+## 基本
 
- <!--@include: ./parts/basics.md#basic-usage{,2}-->
- <!--@include: ./parts/basics.md#basic-usage{5,}-->
- ```
+<!--@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@include: ./parts/basics.md#basic-usage{5,}-->
+```
 
 **パートファイル**（`parts/basics.md`）
 
- ```md:line-numbers
- <!-- #region basic-usage -->
- ## 使用例 1
+```md:line-numbers
+<!-- #region basic-usage -->
+## 使用例 1
 
- ## 使用例 2
+## 使用例 2
 
- ## 使用例 3
- <!-- #endregion basic-usage -->
- ```
+## 使用例 3
+<!-- #endregion basic-usage -->
+```
 
 **等価なコード**
 
- ```md:line-numbers
- # ドキュメント
+```md:line-numbers
+# ドキュメント
 
- ## 基本
+## 基本
 
- ## 使用例 1
+## 使用例 1
 
- ## 使用例 3
- ```
+## 使用例 3
+```
 
 ::: warning
 ファイルが存在しない場合でもエラーは発生しません。したがって、この機能を使う際は、期待どおりに内容がレンダリングされているか必ず確認してください。
@@ -904,50 +900,51 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 VS Code のリージョンの代わりに、ヘッダーアンカーを使ってファイル内の特定セクションだけを取り込むこともできます。たとえば、Markdown ファイルに次のようなヘッダーがある場合：
 
- ```md
- ## ベースのセクション
+```md
+## ベースのセクション
 
- ここに本文。
+ここに本文。
 
- ### サブセクション
+### サブセクション
 
- ここに本文（サブ）。
+ここに本文（サブ）。
 
- ## 別のセクション
+## 別のセクション
 
- `ベースのセクション` の外側の内容。
- ```
+`ベースのセクション` の外側の内容。
+```
 
 `ベースのセクション` を次のように取り込めます：
 
- ```md
- ## 拡張セクション
- <!--@include: ./parts/basics.md#my-base-section-->
- ```
+```md
+## 拡張セクション
+
+<!--@include: ./parts/basics.md#my-base-section-->
+```
 
 **等価なコード**
 
- ```md
- ## 拡張セクション
+```md
+## 拡張セクション
 
- ここに本文。
+ここに本文。
 
- ### サブセクション
+### サブセクション
 
- ここに本文（サブ）。
- ```
+ここに本文（サブ）。
+```
 
 ここで `my-base-section` は見出し要素から生成される ID です。推測しづらい場合は、パートファイルをブラウザで開いて見出しのアンカー（ホバー時に見出しの左に表示される `#` 記号）をクリックし、URL バーで ID を確認してください。あるいはブラウザの開発者ツールで要素を検査して確認できます。別案として、パートファイル側で明示的に ID を指定できます：
 
- ```md
- ## ベースのセクション {#custom-id}
- ```
+```md
+## ベースのセクション {#custom-id}
+```
 
 そして次のように取り込みます：
 
- ```md
- <!--@include: ./parts/basics.md#custom-id-->
- ```
+```md
+<!--@include: ./parts/basics.md#custom-id-->
+```
 
 ## 数式 {#math-equations}
 
@@ -957,84 +954,84 @@ VS Code のリージョンの代わりに、ヘッダーアンカーを使って
 npm add -D markdown-it-mathjax3@^4
 ```
 
- ```ts [.vitepress/config.ts]
- export default {
-   markdown: {
-     math: true
-   }
- }
- ```
+```ts [.vitepress/config.ts]
+export default {
+  markdown: {
+    math: true
+  }
+}
+```
 
 **入力**
 
- ```md
- もし $a \ne 0$ のとき、$(ax^2 + bx + c = 0)$ の解は 2 つ存在し、次式で与えられます
- $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
+```md
+もし $a \ne 0$ のとき、$(ax^2 + bx + c = 0)$ の解は 2 つ存在し、次式で与えられます
+$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
 
- **マクスウェル方程式:**
+**マクスウェル方程式:**
 
- | 方程式                                                                                                                                                                   | 説明                                                                                       |
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
- | $\nabla \cdot \vec{\mathbf{B}}  = 0$                                                                                                                                     | 磁束密度 $\vec{\mathbf{B}}$ の発散は 0                                                     |
- | $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                         | 電場 $\vec{\mathbf{E}}$ の回転は、磁束密度 $\vec{\mathbf{B}}$ の時間変化に比例              |
- | $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _え？_                                                                                      |
- ```
+| 方程式                                                                                                                                                                    | 説明                                                                           |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| $\nabla \cdot \vec{\mathbf{B}}  = 0$                                                                                                                                      | 磁束密度 $\vec{\mathbf{B}}$ の発散は 0                                         |
+| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                          | 電場 $\vec{\mathbf{E}}$ の回転は、磁束密度 $\vec{\mathbf{B}}$ の時間変化に比例 |
+| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _え？_                                                                         |
+```
 
 **出力**
 
- もし $a \ne 0$ のとき、$(ax^2 + bx + c = 0)$ の解は 2 つ存在し、次式で与えられます
- $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
+もし $a \ne 0$ のとき、$(ax^2 + bx + c = 0)$ の解は 2 つ存在し、次式で与えられます
+$$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
 
- **マクスウェル方程式:**
+**マクスウェル方程式:**
 
- | 方程式                                                                                                                                                                   | 説明                                                                                       |
- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
- | $\nabla \cdot \vec{\mathbf{B}}  = 0$                                                                                                                                     | 磁束密度 $\vec{\mathbf{B}}$ の発散は 0                                                     |
- | $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                         | 電場 $\vec{\mathbf{E}}$ の回転は、磁束密度 $\vec{\mathbf{B}}$ の時間変化に比例              |
- | $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _え？_                                                                                      |
+| 方程式                                                                                                                                                                    | 説明                                                                           |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| $\nabla \cdot \vec{\mathbf{B}}  = 0$                                                                                                                                      | 磁束密度 $\vec{\mathbf{B}}$ の発散は 0                                         |
+| $\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t}  = \vec{\mathbf{0}}$                                                          | 電場 $\vec{\mathbf{E}}$ の回転は、磁束密度 $\vec{\mathbf{B}}$ の時間変化に比例 |
+| $\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} = \frac{4\pi}{c}\vec{\mathbf{j}}    \nabla \cdot \vec{\mathbf{E}} = 4 \pi \rho$ | _え？_                                                                         |
 
 ## 画像の遅延読み込み {#image-lazy-loading}
 
 Markdown で追加した各画像に対して遅延読み込みを有効化するには、設定ファイルで `lazyLoading` を `true` にします：
 
- ```js
- export default {
-   markdown: {
-     image: {
-       // 既定では画像の遅延読み込みは無効
-       lazyLoading: true
-     }
-   }
- }
- ```
+```js
+export default {
+  markdown: {
+    image: {
+      // 既定では画像の遅延読み込みは無効
+      lazyLoading: true
+    }
+  }
+}
+```
 
 ## 高度な設定 {#advanced-configuration}
 
 VitePress は Markdown レンダラーとして [markdown-it](https://github.com/markdown-it/markdown-it) を使用しています。上記の多くの拡張はカスタムプラグインとして実装されています。`.vitepress/config.js` の `markdown` オプションを使って、`markdown-it` のインスタンスをさらにカスタマイズできます。
 
- ```js
- import { defineConfig } from 'vitepress'
- import markdownItAnchor from 'markdown-it-anchor'
- import markdownItFoo from 'markdown-it-foo'
-
- export default defineConfig({
-   markdown: {
-     // markdown-it-anchor のオプション
-     // https://github.com/valeriangalliat/markdown-it-anchor#usage
-     anchor: {
-       permalink: markdownItAnchor.permalink.headerLink()
-     },
-
-     // @mdit-vue/plugin-toc のオプション
-     // https://github.com/mdit-vue/mdit-vue/tree/main/packages/plugin-toc#options
-     toc: { level: [1, 2] },
-
-     config: (md) => {
-       // markdown-it のプラグインをもっと使えます！
-       md.use(markdownItFoo)
-     }
-   }
- })
- ```
+```js
+import { defineConfig } from 'vitepress'
+import markdownItAnchor from 'markdown-it-anchor'
+import markdownItFoo from 'markdown-it-foo'
+
+export default defineConfig({
+  markdown: {
+    // markdown-it-anchor のオプション
+    // https://github.com/valeriangalliat/markdown-it-anchor#usage
+    anchor: {
+      permalink: markdownItAnchor.permalink.headerLink()
+    },
+
+    // @mdit-vue/plugin-toc のオプション
+    // https://github.com/mdit-vue/mdit-vue/tree/main/packages/plugin-toc#options
+    toc: { level: [1, 2] },
+
+    config: (md) => {
+      // markdown-it のプラグインをもっと使えます！
+      md.use(markdownItFoo)
+    }
+  }
+})
+```
 
 設定可能なプロパティの完全な一覧は、[設定リファレンス: アプリ設定](../reference/site-config#markdown) を参照してください。
diff --git a/docs/ja/guide/mpa-mode.md b/docs/ja/guide/mpa-mode.md
index 312cc3f7..a63251a4 100644
--- a/docs/ja/guide/mpa-mode.md
+++ b/docs/ja/guide/mpa-mode.md
@@ -8,15 +8,15 @@ MPA モードでは、既定で **あらゆるページが JavaScript を含ま
 
 また、「既定で JS なし」ということは、実質的に Vue をサーバーサイドのテンプレート言語としてのみ使うことを意味します。ブラウザ側ではイベントハンドラがアタッチされないため、インタラクティブ性はありません。クライアントサイドの JavaScript を読み込むには、特別な `<script client>` タグを使用します：
 
- ```html
- <script client>
- document.querySelector('h1').addEventListener('click', () => {
-   console.log('client side JavaScript!')
- })
- </script>
-
- # Hello
- ```
+```md
+<script client>
+document.querySelector('h1').addEventListener('click', () => {
+  console.log('client side JavaScript!')
+})
+</script>
+
+# Hello
+```
 
 `<script client>` は VitePress 固有の機能であり、Vue の機能ではありません。`.md` と `.vue` の両方で動作しますが、**MPA モード時のみ** 有効です。テーマコンポーネント内のクライアントスクリプトはひとつにバンドルされ、特定ページ専用のクライアントスクリプトはそのページごとに分割されます。
 
diff --git a/docs/ja/guide/routing.md b/docs/ja/guide/routing.md
index 98545b32..3ad80002 100644
--- a/docs/ja/guide/routing.md
+++ b/docs/ja/guide/routing.md
@@ -8,23 +8,23 @@ outline: deep
 
 VitePress はファイルベースのルーティングを採用しており、生成される HTML はソースの Markdown ファイルのディレクトリ構造に対応します。例えば、次のディレクトリ構造があるとします：
 
- ```
- .
- ├─ guide
- │  ├─ getting-started.md
- │  └─ index.md
- ├─ index.md
- └─ prologue.md
- ```
+```
+.
+├─ guide
+│  ├─ getting-started.md
+│  └─ index.md
+├─ index.md
+└─ prologue.md
+```
 
 生成される HTML は次のとおりです：
 
- ```
- index.md                  -->  /index.html （/ でアクセス可能）
- prologue.md               -->  /prologue.html
- guide/index.md            -->  /guide/index.html （/guide/ でアクセス可能）
- guide/getting-started.md  -->  /guide/getting-started.html
- ```
+```
+index.md                  -->  /index.html （/ でアクセス可能）
+prologue.md               -->  /prologue.html
+guide/index.md            -->  /guide/index.html （/guide/ でアクセス可能）
+guide/getting-started.md  -->  /guide/getting-started.html
+```
 
 生成された HTML は、静的ファイルを配信できる任意の Web サーバーでホストできます。
 
@@ -38,25 +38,25 @@ VitePress プロジェクトのファイル構成には重要な概念が 2 つ
 
 コマンドラインから `vitepress dev` や `vitepress build` を実行すると、VitePress は現在の作業ディレクトリをプロジェクトルートとして使用します。サブディレクトリをルートとして指定したい場合は、コマンドに相対パスを渡します。例えば、VitePress プロジェクトが `./docs` にある場合、`vitepress dev docs` を実行します：
 
- ```
- .
- ├─ docs                    # プロジェクトルート
- │  ├─ .vitepress           # 設定ディレクトリ
- │  ├─ getting-started.md
- │  └─ index.md
- └─ ...
- ```
+```
+.
+├─ docs                    # プロジェクトルート
+│  ├─ .vitepress           # 設定ディレクトリ
+│  ├─ getting-started.md
+│  └─ index.md
+└─ ...
+```
 
- ```sh
- vitepress dev docs
- ```
+```sh
+vitepress dev docs
+```
 
 これにより、ソースから HTML へのマッピングは次のようになります：
 
- ```
- docs/index.md            -->  /index.html （/ でアクセス可能）
- docs/getting-started.md  -->  /getting-started.html
- ```
+```
+docs/index.md            -->  /index.html （/ でアクセス可能）
+docs/getting-started.md  -->  /getting-started.html
+```
 
 ### ソースディレクトリ {#source-directory}
 
@@ -64,34 +64,34 @@ VitePress プロジェクトのファイル構成には重要な概念が 2 つ
 
 `srcDir` はプロジェクトルートからの相対パスで解決されます。例えば `srcDir: 'src'` の場合、ファイル構成は次のようになります：
 
- ```
- .                          # プロジェクトルート
- ├─ .vitepress              # 設定ディレクトリ
- └─ src                     # ソースディレクトリ
-    ├─ getting-started.md
-    └─ index.md
- ```
+```
+.                          # プロジェクトルート
+├─ .vitepress              # 設定ディレクトリ
+└─ src                     # ソースディレクトリ
+   ├─ getting-started.md
+   └─ index.md
+```
 
 ソースから HTML へのマッピングは次のとおりです：
 
- ```
- src/index.md            -->  /index.html （/ でアクセス可能）
- src/getting-started.md  -->  /getting-started.html
- ```
+```
+src/index.md            -->  /index.html （/ でアクセス可能）
+src/getting-started.md  -->  /getting-started.html
+```
 
 ## ページ間リンク {#linking-between-pages}
 
 ページ間のリンクには、絶対パスと相対パスのどちらも使用できます。`.md` と `.html` の拡張子はどちらも機能しますが、最終的な URL を設定に応じて VitePress が生成できるよう、**拡張子は省略する** のがベストプラクティスです。
 
- ```md
- <!-- 良い例 -->
- [はじめに](./getting-started)
- [はじめに](../guide/getting-started)
+```md
+<!-- 良い例 -->
+[はじめに](./getting-started)
+[はじめに](../guide/getting-started)
 
- <!-- 悪い例 -->
- [はじめに](./getting-started.md)
- [はじめに](./getting-started.html)
- ```
+<!-- 悪い例 -->
+[はじめに](./getting-started.md)
+[はじめに](./getting-started.html)
+```
 
 画像などのアセットへのリンクについては、[アセットの取り扱い](./asset-handling) を参照してください。
 
@@ -101,13 +101,13 @@ VitePress プロジェクトのファイル構成には重要な概念が 2 つ
 
 **入力**
 
- ```md
- [pure.html へのリンク](/pure.html){target="_self"}
- ```
+```md
+[pure.html へのリンク](/pure.html){target="_self"}
+```
 
 **出力**
 
- [pure.html へのリンク](/pure.html){target="_self"}
+[pure.html へのリンク](/pure.html){target="_self"}
 
 ::: tip 注意
 
@@ -115,9 +115,9 @@ Markdown のリンクでは、`base` が自動的に URL の先頭に付与さ
 
 あるいは、アンカータグの構文を直接使うこともできます：
 
- ```md
- <a href="/pure.html" target="_self">pure.html へのリンク</a>
- ```
+```md
+<a href="/pure.html" target="_self">pure.html へのリンク</a>
+```
 :::
 
 ## クリーン URL の生成 {#generating-clean-urls}
@@ -140,83 +140,83 @@ VitePress でクリーン URL を提供するには、サーバー側のサポ
 
 もしサーバーをそのように設定できない場合は、次のようなディレクトリ構造に手動でする必要があります：
 
- ```
- .
- ├─ getting-started
- │  └─ index.md
- ├─ installation
- │  └─ index.md
- └─ index.md
- ```
+```
+.
+├─ getting-started
+│  └─ index.md
+├─ installation
+│  └─ index.md
+└─ index.md
+```
 
 ## ルートのリライト {#route-rewrites}
 
 ソースディレクトリ構造と生成ページのマッピングをカスタマイズできます。これは複雑なプロジェクト構成で有用です。例えば、複数パッケージを持つモノレポで、ソースファイルと並べてドキュメントを配置したい場合：
 
- ```
- .
- └─ packages
-    ├─ pkg-a
-    │  └─ src
-    │     ├─ foo.md
-    │     └─ index.md
-    └─ pkg-b
-       └─ src
-          ├─ bar.md
-          └─ index.md
- ```
+```
+.
+└─ packages
+   ├─ pkg-a
+   │  └─ src
+   │     ├─ foo.md
+   │     └─ index.md
+   └─ pkg-b
+      └─ src
+         ├─ bar.md
+         └─ index.md
+```
 
 生成したいページが次のような場合：
 
- ```
- packages/pkg-a/src/index.md  -->  /pkg-a/index.html
- packages/pkg-a/src/foo.md    -->  /pkg-a/foo.html
- packages/pkg-b/src/index.md  -->  /pkg-b/index.html
- packages/pkg-b/src/bar.md    -->  /pkg-b/bar.html
- ```
+```
+packages/pkg-a/src/index.md  -->  /pkg-a/index.html
+packages/pkg-a/src/foo.md    -->  /pkg-a/foo.html
+packages/pkg-b/src/index.md  -->  /pkg-b/index.html
+packages/pkg-b/src/bar.md    -->  /pkg-b/bar.html
+```
 
 [`rewrites`](../reference/site-config#rewrites) オプションを次のように設定します：
 
- ```ts [.vitepress/config.js]
- export default {
-   rewrites: {
-     'packages/pkg-a/src/index.md': 'pkg-a/index.md',
-     'packages/pkg-a/src/foo.md': 'pkg-a/foo.md',
-     'packages/pkg-b/src/index.md': 'pkg-b/index.md',
-     'packages/pkg-b/src/bar.md': 'pkg-b/bar.md'
-   }
- }
- ```
+```ts [.vitepress/config.js]
+export default {
+  rewrites: {
+    'packages/pkg-a/src/index.md': 'pkg-a/index.md',
+    'packages/pkg-a/src/foo.md': 'pkg-a/foo.md',
+    'packages/pkg-b/src/index.md': 'pkg-b/index.md',
+    'packages/pkg-b/src/bar.md': 'pkg-b/bar.md'
+  }
+}
+```
 
 `rewrites` は動的なルートパラメータにも対応しています。上記の例で多くのパッケージがある場合、同じ構造なら次のように簡略化できます：
 
- ```ts
- export default {
-   rewrites: {
-     'packages/:pkg/src/:slug*': ':pkg/:slug*'
-   }
- }
- ```
+```ts
+export default {
+  rewrites: {
+    'packages/:pkg/src/:slug*': ':pkg/:slug*'
+  }
+}
+```
 
 リライトのパスは `path-to-regexp` パッケージでコンパイルされます。高度な構文は[ドキュメント](https://github.com/pillarjs/path-to-regexp/tree/6.x#parameters)を参照してください。
 
 `rewrites` は、元のパスを受け取って新しいパスを返す **関数** として定義することもできます：
 
- ```ts
- export default {
-   rewrites(id) {
-     return id.replace(/^packages\/([^/]+)\/src\//, '$1/')
-   }
- }
- ```
+```ts
+export default {
+  rewrites(id) {
+    return id.replace(/^packages\/([^/]+)\/src\//, '$1/')
+  }
+}
+```
 
 ::: warning リライト時の相対リンク
 
 リライトを有効にした場合、**相対リンクはリライト後のパスに基づいて** 記述してください。例えば、`packages/pkg-a/src/pkg-a-code.md` から `packages/pkg-b/src/pkg-b-code.md` への相対リンクを作るには、次のように書きます：
 
- ```md
- [PKG B へのリンク](../pkg-b/pkg-b-code)
- ```
+```md
+[PKG B へのリンク](../pkg-b/pkg-b-code)
+```
 :::
 
 ## 動的ルート {#dynamic-routes}
@@ -227,37 +227,37 @@ VitePress でクリーン URL を提供するには、サーバー側のサポ
 
 VitePress は静的サイトジェネレーターなので、生成可能なページパスはビルド時に確定している必要があります。したがって、動的ルートページには **パスローダーファイル** が **必須** です。`packages/[pkg].md` に対しては `packages/[pkg].paths.js`（`.ts` も可）が必要です：
 
- ```
- .
- └─ packages
-    ├─ [pkg].md         # ルートテンプレート
-    └─ [pkg].paths.js   # ルートのパスローダー
- ```
+```
+.
+└─ packages
+   ├─ [pkg].md         # ルートテンプレート
+   └─ [pkg].paths.js   # ルートのパスローダー
+```
 
 パスローダーは、`paths` メソッドを持つオブジェクトをデフォルトエクスポートします。`paths` は `params` プロパティを持つオブジェクトの配列を返します。各オブジェクトが 1 ページに対応します。
 
 例えば次の `paths` 配列を返すと：
 
- ```js
- // packages/[pkg].paths.js
- export default {
-   paths() {
-     return [
-       { params: { pkg: 'foo' }},
-       { params: { pkg: 'bar' }}
-     ]
-   }
- }
- ```
+```js
+// packages/[pkg].paths.js
+export default {
+  paths() {
+    return [
+      { params: { pkg: 'foo' } },
+      { params: { pkg: 'bar' } }
+    ]
+  }
+}
+```
 
 生成される HTML は次のようになります：
 
- ```
- .
- └─ packages
-    ├─ foo.html
-    └─ bar.html
- ```
+```
+.
+└─ packages
+   ├─ foo.html
+   └─ bar.html
+```
 
 ### 複数パラメータ {#multiple-params}
 
@@ -265,36 +265,36 @@ VitePress は静的サイトジェネレーターなので、生成可能なペ
 
 **ファイル構成**
 
- ```
- .
- └─ packages
-    ├─ [pkg]-[version].md
-    └─ [pkg]-[version].paths.js
- ```
+```
+.
+└─ packages
+   ├─ [pkg]-[version].md
+   └─ [pkg]-[version].paths.js
+```
 
 **パスローダー**
 
- ```js
- export default {
-   paths: () => [
-     { params: { pkg: 'foo', version: '1.0.0' }},
-     { params: { pkg: 'foo', version: '2.0.0' }},
-     { params: { pkg: 'bar', version: '1.0.0' }},
-     { params: { pkg: 'bar', version: '2.0.0' }}
-   ]
- }
- ```
+```js
+export default {
+  paths: () => [
+    { params: { pkg: 'foo', version: '1.0.0' } },
+    { params: { pkg: 'foo', version: '2.0.0' } },
+    { params: { pkg: 'bar', version: '1.0.0' } },
+    { params: { pkg: 'bar', version: '2.0.0' } }
+  ]
+}
+```
 
 **出力**
 
- ```
- .
- └─ packages
-    ├─ foo-1.0.0.html
-    ├─ foo-2.0.0.html
-    ├─ bar-1.0.0.html
-    └─ bar-2.0.0.html
- ```
+```
+.
+└─ packages
+   ├─ foo-1.0.0.html
+   ├─ foo-2.0.0.html
+   ├─ bar-1.0.0.html
+   └─ bar-2.0.0.html
+```
 
 ### パスを動的に生成する {#dynamically-generating-paths}
 
@@ -302,60 +302,60 @@ VitePress は静的サイトジェネレーターなので、生成可能なペ
 
 ローカルファイルから生成する例：
 
- ```js
- import fs from 'fs'
+```js
+import fs from 'fs'
 
- export default {
-   paths() {
-     return fs
-       .readdirSync('packages')
-       .map((pkg) => {
-         return { params: { pkg } }
-       })
-   }
- }
- ```
+export default {
+  paths() {
+    return fs
+      .readdirSync('packages')
+      .map((pkg) => {
+      return { params: { pkg } }
+    })
+  }
+}
+```
 
 リモートデータから生成する例：
 
- ```js
- export default {
-   async paths() {
-     const pkgs = await (await fetch('https://my-api.com/packages')).json()
-
-     return pkgs.map((pkg) => {
-       return {
-         params: {
-           pkg: pkg.name,
-           version: pkg.version
-         }
-       }
-     })
-   }
- }
- ```
+```js
+export default {
+  async paths() {
+    const pkgs = await (await fetch('https://my-api.com/packages')).json()
+
+    return pkgs.map((pkg) => {
+      return {
+        params: {
+          pkg: pkg.name,
+          version: pkg.version
+        }
+      }
+    })
+  }
+}
+```
 
 ### ページ内でパラメータにアクセスする {#accessing-params-in-page}
 
 各ページへ追加データを渡すために、パラメータを利用できます。Markdown のルートファイルでは、Vue 式内で `$params` グローバルプロパティから現在ページのパラメータにアクセスできます：
 
- ```md
- - パッケージ名: {{ $params.pkg }}
- - バージョン: {{ $params.version }}
- ```
+```md
+- パッケージ名: {{ $params.pkg }}
+- バージョン: {{ $params.version }}
+```
 
 [`useData`](../reference/runtime-api#usedata) ランタイム API からも、現在ページのパラメータにアクセスできます（Markdown と Vue コンポーネントの両方で利用可能）：
 
- ```vue
- <script setup>
- import { useData } from 'vitepress'
+```vue
+<script setup>
+import { useData } from 'vitepress'
 
- // params は Vue の ref
- const { params } = useData()
+// params は Vue の ref
+const { params } = useData()
 
- console.log(params.value)
- </script>
- ```
+console.log(params.value)
+</script>
+```
 
 ### 生コンテンツのレンダリング {#rendering-raw-content}
 
@@ -363,23 +363,23 @@ VitePress は静的サイトジェネレーターなので、生成可能なペ
 
 代わりに、各パスオブジェクトの `content` プロパティでコンテンツを渡せます：
 
- ```js
- export default {
-   async paths() {
-     const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
-
-     return posts.map((post) => {
-       return {
-         params: { id: post.id },
-         content: post.content // 生の Markdown または HTML
-       }
-     })
-   }
- }
- ```
+```js
+export default {
+  async paths() {
+    const posts = await (await fetch('https://my-cms.com/blog-posts')).json()
+
+    return posts.map((post) => {
+      return {
+        params: { id: post.id },
+        content: post.content // 生の Markdown または HTML
+      }
+    })
+  }
+}
+```
 
 そのうえで、Markdown ファイル内で次の特別な構文を使って、そのコンテンツを埋め込みます：
 
- ```md
- <!-- @content -->
- ```
+```md
+<!-- @content -->
+```
diff --git a/docs/ja/guide/sitemap-generation.md b/docs/ja/guide/sitemap-generation.md
index db44942c..0d2e4645 100644
--- a/docs/ja/guide/sitemap-generation.md
+++ b/docs/ja/guide/sitemap-generation.md
@@ -2,13 +2,13 @@
 
 VitePress には、サイト用の `sitemap.xml` を生成する機能が標準で用意されています。有効化するには、`.vitepress/config.js` に次を追加します。
 
- ```ts
- export default {
-   sitemap: {
-     hostname: 'https://example.com'
-   }
- }
- ```
+```ts
+export default {
+  sitemap: {
+    hostname: 'https://example.com'
+  }
+}
+```
 
 `siteamp.xml` に `<lastmod>` タグを含めるには、[`lastUpdated`](../reference/default-theme-last-updated) オプションを有効にします。
 
@@ -16,43 +16,43 @@ VitePress には、サイト用の `sitemap.xml` を生成する機能が標準
 
 サイトマップ生成は [`sitemap`](https://www.npmjs.com/package/sitemap) モジュールで行われます。設定ファイルの `sitemap` に、このモジュールがサポートする任意のオプションを渡せます。指定した値はそのまま `SitemapStream` コンストラクタに渡されます。詳しくは [`sitemap` のドキュメント](https://www.npmjs.com/package/sitemap#options-you-can-pass) を参照してください。例：
 
- ```ts
- export default {
-   sitemap: {
-     hostname: 'https://example.com',
-     lastmodDateOnly: false
-   }
- }
- ```
+```ts
+export default {
+  sitemap: {
+    hostname: 'https://example.com',
+    lastmodDateOnly: false
+  }
+}
+```
 
 設定で `base` を使っている場合は、`hostname` にもそれを付与してください：
 
- ```ts
- export default {
-   base: '/my-site/',
-   sitemap: {
-     hostname: 'https://example.com/my-site/'
-   }
- }
- ```
+```ts
+export default {
+  base: '/my-site/',
+  sitemap: {
+    hostname: 'https://example.com/my-site/'
+  }
+}
+```
 
 ## `transformItems` フック {#transformitems-hook}
 
 `siteamp.xml` に書き出す直前にサイトマップ項目を加工するには、`sitemap.transformItems` フックを使います。このフックはサイトマップ項目の配列を受け取り、配列を返す必要があります。例：
 
- ```ts
- export default {
-   sitemap: {
-     hostname: 'https://example.com',
-     transformItems: (items) => {
-       // 既存項目の追加・変更・フィルタリングが可能
-       items.push({
-         url: '/extra-page',
-         changefreq: 'monthly',
-         priority: 0.8
-       })
-       return items
-     }
-   }
- }
- ```
+```ts
+export default {
+  sitemap: {
+    hostname: 'https://example.com',
+    transformItems: (items) => {
+      // 既存項目の追加・変更・フィルタリングが可能
+      items.push({
+        url: '/extra-page',
+        changefreq: 'monthly',
+        priority: 0.8
+      })
+      return items
+    }
+  }
+}
+```
diff --git a/docs/ja/guide/ssr-compat.md b/docs/ja/guide/ssr-compat.md
index d756d6d1..f72a2aad 100644
--- a/docs/ja/guide/ssr-compat.md
+++ b/docs/ja/guide/ssr-compat.md
@@ -12,11 +12,11 @@ VitePress は本番ビルド時に、Node.js 上で Vue のサーバーサイド
 
 SSR に適さないコンポーネント（例：カスタムディレクティブを含むなど）を使用・デモする場合は、組み込みの `<ClientOnly>` コンポーネントでラップできます。
 
- ```md
- <ClientOnly>
-   <NonSSRFriendlyComponent />
- </ClientOnly>
- ```
+```md
+<ClientOnly>
+  <NonSSRFriendlyComponent />
+</ClientOnly>
+```
 
 ## インポート時に Browser API にアクセスするライブラリ {#libraries-that-access-browser-api-on-import}
 
@@ -24,112 +24,112 @@ SSR に適さないコンポーネント（例：カスタムディレクティ
 
 ### mounted フック内でのインポート {#importing-in-mounted-hook}
 
- ```vue
- <script setup>
- import { onMounted } from 'vue'
+```vue
+<script setup>
+import { onMounted } from 'vue'
 
- onMounted(() => {
-   import('./lib-that-access-window-on-import').then((module) => {
-     // ここでコードを利用
-   })
- })
- </script>
- ```
+onMounted(() => {
+  import('./lib-that-access-window-on-import').then((module) => {
+    // ここでコードを利用
+  })
+})
+</script>
+```
 
 ### 条件付きインポート {#conditional-import}
 
 [`import.meta.env.SSR`](https://vitejs.dev/guide/env-and-mode.html#env-variables) フラグ（Vite の環境変数の一部）を使って、依存関係を条件付きでインポートすることもできます。
 
- ```js
- if (!import.meta.env.SSR) {
-   import('./lib-that-access-window-on-import').then((module) => {
-     // ここでコードを利用
-   })
- }
- ```
+```js
+if (!import.meta.env.SSR) {
+  import('./lib-that-access-window-on-import').then((module) => {
+    // ここでコードを利用
+  })
+}
+```
 
 [`Theme.enhanceApp`](./custom-theme#theme-interface) は非同期にできるため、**インポート時に Browser API に触れる Vue プラグイン** を条件付きでインポート・登録できます。
 
- ```js [.vitepress/theme/index.js]
- /** @type {import('vitepress').Theme} */
- export default {
-   // ...
-   async enhanceApp({ app }) {
-     if (!import.meta.env.SSR) {
-       const plugin = await import('plugin-that-access-window-on-import')
-       app.use(plugin.default)
-     }
-   }
- }
- ```
+```js [.vitepress/theme/index.js]
+/** @type {import('vitepress').Theme} */
+export default {
+  // ...
+  async enhanceApp({ app }) {
+    if (!import.meta.env.SSR) {
+      const plugin = await import('plugin-that-access-window-on-import')
+      app.use(plugin.default)
+    }
+  }
+}
+```
 
 TypeScript を使う場合：
 
- ```ts [.vitepress/theme/index.ts]
- import type { Theme } from 'vitepress'
+```ts [.vitepress/theme/index.ts]
+import type { Theme } from 'vitepress'
 
- export default {
-   // ...
-   async enhanceApp({ app }) {
-     if (!import.meta.env.SSR) {
-       const plugin = await import('plugin-that-access-window-on-import')
-       app.use(plugin.default)
-     }
-   }
- } satisfies Theme
- ```
+export default {
+  // ...
+  async enhanceApp({ app }) {
+    if (!import.meta.env.SSR) {
+      const plugin = await import('plugin-that-access-window-on-import')
+      app.use(plugin.default)
+    }
+  }
+} satisfies Theme
+```
 
 ### `defineClientComponent`
 
 VitePress は、**インポート時に Browser API にアクセスする Vue コンポーネント** を読み込むためのユーティリティを提供します。
 
- ```vue
- <script setup>
- import { defineClientComponent } from 'vitepress'
+```vue
+<script setup>
+import { defineClientComponent } from 'vitepress'
 
- const ClientComp = defineClientComponent(() => {
-   return import('component-that-access-window-on-import')
- })
- </script>
+const ClientComp = defineClientComponent(() => {
+  return import('component-that-access-window-on-import')
+})
+</script>
 
- <template>
-   <ClientComp />
- </template>
- ```
+<template>
+  <ClientComp />
+</template>
+```
 
 ターゲットコンポーネントに props / children / slots を渡すこともできます。
 
- ```vue
- <script setup>
- import { ref } from 'vue'
- import { defineClientComponent } from 'vitepress'
-
- const clientCompRef = ref(null)
- const ClientComp = defineClientComponent(
-   () => import('component-that-access-window-on-import'),
-
-   // 引数は h() に渡されます - https://vuejs.org/api/render-function.html#h
-   [
-     {
-       ref: clientCompRef
-     },
-     {
-       default: () => 'default slot',
-       foo: () => h('div', 'foo'),
-       bar: () => [h('span', 'one'), h('span', 'two')]
-     }
-   ],
-
-   // コンポーネント読み込み後のコールバック（非同期可）
-   () => {
-     console.log(clientCompRef.value)
-   }
- )
- </script>
-
- <template>
-   <ClientComp />
- </template>
- ```
+```vue
+<script setup>
+import { ref } from 'vue'
+import { defineClientComponent } from 'vitepress'
+
+const clientCompRef = ref(null)
+const ClientComp = defineClientComponent(
+  () => import('component-that-access-window-on-import'),
+
+  // 引数は h() に渡されます - https://vuejs.org/api/render-function.html#h
+  [
+    {
+      ref: clientCompRef
+    },
+    {
+      default: () => 'default slot',
+      foo: () => h('div', 'foo'),
+      bar: () => [h('span', 'one'), h('span', 'two')]
+    }
+  ],
+
+  // コンポーネント読み込み後のコールバック（非同期可）
+  () => {
+    console.log(clientCompRef.value)
+  }
+)
+</script>
+
+<template>
+  <ClientComp />
+</template>
+```
 
 ターゲットコンポーネントは、ラッパーコンポーネントの mounted フックで初めてインポートされます。
diff --git a/docs/ja/guide/using-vue.md b/docs/ja/guide/using-vue.md
index 65f2383e..d71d245f 100644
--- a/docs/ja/guide/using-vue.md
+++ b/docs/ja/guide/using-vue.md
@@ -16,9 +16,9 @@ Vue の使用は SSR 互換である必要があります。詳細と一般的
 
 **入力**
 
- ```md
- {{ 1 + 1 }}
- ```
+```md
+{{ 1 + 1 }}
+```
 
 **出力**
 
@@ -30,9 +30,9 @@ Vue の使用は SSR 互換である必要があります。詳細と一般的
 
 **入力**
 
- ```html
- <span v-for="i in 3">{{ i }}</span>
- ```
+```html
+<span v-for="i in 3">{{ i }}</span>
+```
 
 **出力**
 
@@ -42,30 +42,30 @@ Vue の使用は SSR 互換である必要があります。詳細と一般的
 
 Markdown ファイルのルート直下に置く `<script>` と `<style>` タグは、Vue の SFC と同様に動作します（`<script setup>` や `<style module>` などを含む）。大きな違いは `<template>` タグが無い点で、その他のルート直下のコンテンツは Markdown になることです。すべてのタグはフロントマターの**後**に配置してください。
 
- ```html
- ---
- hello: world
- ---
+```md
+---
+hello: world
+---
 
- <script setup>
- import { ref } from 'vue'
+<script setup>
+import { ref } from 'vue'
 
- const count = ref(0)
- </script>
+const count = ref(0)
+</script>
 
- ## Markdown コンテンツ
+## Markdown コンテンツ
 
- 現在の値: {{ count }}
+現在の値: {{ count }}
 
- <button :class="$style.button" @click="count++">Increment</button>
+<button :class="$style.button" @click="count++">Increment</button>
 
- <style module>
- .button {
-   color: red;
-   font-weight: bold;
- }
- </style>
- ```
+<style module>
+.button {
+  color: red;
+  font-weight: bold;
+}
+</style>
+```
 
 ::: warning Markdown での `<style scoped>` は避ける
 Markdown で `<style scoped>` を使うと、そのページ内のすべての要素に特殊な属性を付与する必要があり、ページサイズが大きく膨らみます。ページ単位でローカルスコープが必要な場合は `<style module>` を推奨します。
@@ -75,26 +75,26 @@ VitePress のランタイム API（例：現在ページのメタデータにア
 
 **入力**
 
- ```html
- <script setup>
- import { useData } from 'vitepress'
+```md
+<script setup>
+import { useData } from 'vitepress'
 
- const { page } = useData()
- </script>
+const { page } = useData()
+</script>
 
- <pre>{{ page }}</pre>
- ```
+<pre>{{ page }}</pre>
+```
 
 **出力**
 
- ```json
- {
-   "path": "/using-vue.html",
-   "title": "Using Vue in Markdown",
-   "frontmatter": {},
-   ...
- }
- ```
+```json
+{
+  "path": "/using-vue.html",
+  "title": "Using Vue in Markdown",
+  "frontmatter": {},
+  ...
+}
+```
 
 ## コンポーネントの利用 {#using-components}
 
@@ -104,21 +104,21 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 特定のページでしか使わないコンポーネントは、そのページで明示的にインポートするのがおすすめです。これにより適切にコード分割され、該当ページでのみ読み込まれます。
 
- ```md
- <script setup>
- import CustomComponent from '../components/CustomComponent.vue'
- </script>
+```md
+<script setup>
+import CustomComponent from '../components/CustomComponent.vue'
+</script>
 
- # ドキュメント
+# ドキュメント
 
- これはカスタムコンポーネントを使う .md です
+これはカスタムコンポーネントを使う .md です
 
- <CustomComponent />
+<CustomComponent />
 
- ## 続き
+## 続き
 
- ...
- ```
+...
+```
 
 ### グローバル登録 {#registering-components-globally}
 
@@ -132,10 +132,10 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 見出し内で Vue コンポーネントを使うこともできますが、次の書き方の違いに注意してください。
 
-| Markdown                                                | 出力 HTML                                   | 解析される見出し |
-| ------------------------------------------------------- | ------------------------------------------- | --------------- |
-| <pre v-pre><code> # text &lt;Tag/&gt; </code></pre>     | `<h1>text <Tag/></h1>`                      | `text`          |
-| <pre v-pre><code> # text \`&lt;Tag/&gt;\` </code></pre> | `<h1>text <code>&lt;Tag/&gt;</code></h1>`   | `text <Tag/>`   |
+| Markdown                                                | 出力 HTML                                 | 解析される見出し |
+| ------------------------------------------------------- | ----------------------------------------- | ---------------- |
+| <pre v-pre><code> # text &lt;Tag/&gt; </code></pre>     | `<h1>text <Tag/></h1>`                    | `text`           |
+| <pre v-pre><code> # text \`&lt;Tag/&gt;\` </code></pre> | `<h1>text <code>&lt;Tag/&gt;</code></h1>` | `text <Tag/>`    |
 
 `<code>` に包まれた HTML はそのまま表示されます。包まれて**いない** HTML だけが Vue によってパースされます。
 
@@ -149,9 +149,9 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 **入力**
 
- ```md
- This <span v-pre>{{ will be displayed as-is }}</span>
- ```
+```md
+This <span v-pre>{{ will be displayed as-is }}</span>
+```
 
 **出力**
 
@@ -161,19 +161,19 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 段落全体を `v-pre` のカスタムコンテナで囲む方法もあります。
 
- ```md
- ::: v-pre
- {{ This will be displayed as-is }}
- :::
- ```
+```md
+::: v-pre
+{{ This will be displayed as-is }}
+:::
+```
 
 **出力**
 
  <div class="escape-demo">
 
- ::: v-pre
- {{ This will be displayed as-is }}
- :::
+::: v-pre
+{{ This will be displayed as-is }}
+:::
 
  </div>
 
@@ -183,17 +183,17 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 **入力**
 
- ````md
- ```js-vue
- Hello {{ 1 + 1 }}
- ```
- ````
+````md
+```js-vue
+Hello {{ 1 + 1 }}
+```
+````
 
 **出力**
 
- ```js-vue
- Hello {{ 1 + 1 }}
- ```
+```js-vue
+Hello {{ 1 + 1 }}
+```
 
 この方法では、一部のトークンが正しくシンタックスハイライトされない場合があります。
 
@@ -201,25 +201,25 @@ Markdown ファイルで、Vue コンポーネントを直接インポートし
 
 VitePress は CSS プリプロセッサ（`.scss`、`.sass`、`.less`、`.styl`、`.stylus`）を[標準サポート](https://vitejs.dev/guide/features.html#css-pre-processors)しています。Vite 固有のプラグインは不要ですが、各プリプロセッサ本体のインストールは必要です。
 
- ```
- # .scss / .sass
- npm install -D sass
+```
+# .scss / .sass
+npm install -D sass
 
- # .less
- npm install -D less
+# .less
+npm install -D less
 
- # .styl / .stylus
- npm install -D stylus
- ```
+# .styl / .stylus
+npm install -D stylus
+```
 
 その後、Markdown やテーマコンポーネントで次のように使えます。
 
- ```vue
- <style lang="sass">
- .title
-   font-size: 20px
- </style>
- ```
+```vue
+<style lang="sass">
+.title
+  font-size: 20px
+</style>
+```
 
 ## Teleport の利用 {#using-teleports}
 
@@ -231,15 +231,15 @@ VitePress は CSS プリプロセッサ（`.scss`、`.sass`、`.less`、`.styl`
 <<< @/components/ModalDemo.vue
 :::
 
- ```md
- <ClientOnly>
-   <Teleport to="#modal">
-     <div>
-       // ...
-     </div>
-   </Teleport>
- </ClientOnly>
- ```
+```md
+<ClientOnly>
+  <Teleport to="#modal">
+    <div>
+      // ...
+    </div>
+  </Teleport>
+</ClientOnly>
+```
 
 <script setup>
 import ModalDemo from '../../components/ModalDemo.vue'
@@ -262,27 +262,27 @@ Vue は [Vue - Official VS Code plugin](https://marketplace.visualstudio.com/ite
 
 1. tsconfig/jsconfig の `include` と `vueCompilerOptions.vitePressExtensions` に `.md` パターンを追加します。
 
- ::: code-group
- ```json [tsconfig.json]
- {
-   "include": [
-     "docs/**/*.ts",
-     "docs/**/*.vue",
-     "docs/**/*.md",
-   ],
-   "vueCompilerOptions": {
-     "vitePressExtensions": [".md"],
-   },
- }
- ```
- :::
+::: code-group
+```json [tsconfig.json]
+{
+  "include": [
+    "docs/**/*.ts",
+    "docs/**/*.vue",
+    "docs/**/*.md"
+  ],
+  "vueCompilerOptions": {
+    "vitePressExtensions": [".md"]
+  }
+}
+```
+:::
 
 2. VS Code の設定で、`vue.server.includeLanguages` に `markdown` を追加します。
 
- ::: code-group
- ```json [.vscode/settings.json]
- {
-   "vue.server.includeLanguages": ["vue", "markdown"]
- }
- ```
- :::
+::: code-group
+```json [.vscode/settings.json]
+{
+  "vue.server.includeLanguages": ["vue", "markdown"]
+}
+```
+:::
diff --git a/docs/ja/reference/cli.md b/docs/ja/reference/cli.md
index 78d06b8b..bb304fd1 100644
--- a/docs/ja/reference/cli.md
+++ b/docs/ja/reference/cli.md
@@ -6,24 +6,24 @@
 
 ### 使い方 {#usage}
 
- ```sh
- # カレントディレクトリで起動（`dev` を省略）
- vitepress
+```sh
+# カレントディレクトリで起動（`dev` を省略）
+vitepress
 
- # サブディレクトリで起動
- vitepress dev [root]
- ```
+# サブディレクトリで起動
+vitepress dev [root]
+```
 
 ### オプション {#options}
 
-| オプション         | 説明                                                                 |
-| ------------------ | -------------------------------------------------------------------- |
-| `--open [path]`    | 起動時にブラウザを開く（`boolean \| string`）                        |
-| `--port <port>`    | ポート番号を指定（`number`）                                         |
-| `--base <path>`    | 公開時のベースパス（既定: `/`）（`string`）                          |
-| `--cors`           | CORS を有効化                                                         |
-| `--strictPort`     | 指定ポートが使用中なら終了（`boolean`）                               |
-| `--force`          | 最適化時にキャッシュを無視して再バンドル（`boolean`）                |
+| オプション      | 説明                                                  |
+| --------------- | ----------------------------------------------------- |
+| `--open [path]` | 起動時にブラウザを開く（`boolean \| string`）         |
+| `--port <port>` | ポート番号を指定（`number`）                          |
+| `--base <path>` | 公開時のベースパス（既定: `/`）（`string`）           |
+| `--cors`        | CORS を有効化                                         |
+| `--strictPort`  | 指定ポートが使用中なら終了（`boolean`）               |
+| `--force`       | 最適化時にキャッシュを無視して再バンドル（`boolean`） |
 
 ## `vitepress build`
 
@@ -31,19 +31,19 @@
 
 ### 使い方 {#usage-1}
 
- ```sh
- vitepress build [root]
- ```
+```sh
+vitepress build [root]
+```
 
 ### オプション {#options-1}
 
-| オプション                      | 説明                                                                                               |
-| ----------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--mpa`（実験的）              | クライアント側ハイドレーションなしの [MPA モード](../guide/mpa-mode) でビルド（`boolean`）           |
-| `--base <path>`               | 公開時のベースパス（既定: `/`）（`string`）                                                          |
-| `--target <target>`           | トランスパイルターゲット（既定: `"modules"`）（`string`）                                            |
-| `--outDir <dir>`              | 出力先ディレクトリ（**cwd** からの相対）（既定: `<root>/.vitepress/dist`）（`string`）               |
-| `--assetsInlineLimit <number>`| 静的アセットを base64 インライン化する閾値（バイト）（既定: `4096`）（`number`）                     |
+| オプション                     | 説明                                                                                       |
+| ------------------------------ | ------------------------------------------------------------------------------------------ |
+| `--mpa`（実験的）              | クライアント側ハイドレーションなしの [MPA モード](../guide/mpa-mode) でビルド（`boolean`） |
+| `--base <path>`                | 公開時のベースパス（既定: `/`）（`string`）                                                |
+| `--target <target>`            | トランスパイルターゲット（既定: `"modules"`）（`string`）                                  |
+| `--outDir <dir>`               | 出力先ディレクトリ（**cwd** からの相対）（既定: `<root>/.vitepress/dist`）（`string`）     |
+| `--assetsInlineLimit <number>` | 静的アセットを base64 インライン化する閾値（バイト）（既定: `4096`）（`number`）           |
 
 ## `vitepress preview`
 
@@ -51,16 +51,16 @@
 
 ### 使い方 {#usage-2}
 
- ```sh
- vitepress preview [root]
- ```
+```sh
+vitepress preview [root]
+```
 
 ### オプション {#options-2}
 
-| オプション         | 説明                                      |
-| ------------------ | ----------------------------------------- |
-| `--base <path>`    | 公開時のベースパス（既定: `/`）（`string`） |
-| `--port <port>`    | ポート番号を指定（`number`）               |
+| オプション      | 説明                                        |
+| --------------- | ------------------------------------------- |
+| `--base <path>` | 公開時のベースパス（既定: `/`）（`string`） |
+| `--port <port>` | ポート番号を指定（`number`）                |
 
 ## `vitepress init`
 
@@ -68,6 +68,6 @@
 
 ### 使い方 {#usage-3}
 
- ```sh
- vitepress init
- ```
+```sh
+vitepress init
+```
diff --git a/docs/ja/reference/default-theme-badge.md b/docs/ja/reference/default-theme-badge.md
index 034f1a2f..50526943 100644
--- a/docs/ja/reference/default-theme-badge.md
+++ b/docs/ja/reference/default-theme-badge.md
@@ -6,12 +6,12 @@
 
 グローバルに利用可能な `Badge` コンポーネントを使用します。
 
- ```html
- ### Title <Badge type="info" text="default" />
- ### Title <Badge type="tip" text="^1.9.0" />
- ### Title <Badge type="warning" text="beta" />
- ### Title <Badge type="danger" text="caution" />
- ```
+```md
+### Title <Badge type="info" text="default" />
+### Title <Badge type="tip" text="^1.9.0" />
+### Title <Badge type="warning" text="beta" />
+### Title <Badge type="danger" text="caution" />
+```
 
 上記のコードは次のように表示されます：
 
@@ -24,9 +24,9 @@
 
 `<Badge>` は子要素（`children`）を受け取り、バッジ内に表示できます。
 
- ```html
- ### Title <Badge type="info">custom element</Badge>
- ```
+```md
+### Title <Badge type="info">custom element</Badge>
+```
 
 ### Title <Badge type="info">custom element</Badge>
 
@@ -34,36 +34,36 @@
 
 CSS 変数を上書きすることで、バッジのスタイルをカスタマイズできます。以下はデフォルト値です：
 
- ```css
- :root {
-   --vp-badge-info-border: transparent;
-   --vp-badge-info-text: var(--vp-c-text-2);
-   --vp-badge-info-bg: var(--vp-c-default-soft);
+```css
+:root {
+  --vp-badge-info-border: transparent;
+  --vp-badge-info-text: var(--vp-c-text-2);
+  --vp-badge-info-bg: var(--vp-c-default-soft);
 
-   --vp-badge-tip-border: transparent;
-   --vp-badge-tip-text: var(--vp-c-brand-1);
-   --vp-badge-tip-bg: var(--vp-c-brand-soft);
+  --vp-badge-tip-border: transparent;
+  --vp-badge-tip-text: var(--vp-c-brand-1);
+  --vp-badge-tip-bg: var(--vp-c-brand-soft);
 
-   --vp-badge-warning-border: transparent;
-   --vp-badge-warning-text: var(--vp-c-warning-1);
-   --vp-badge-warning-bg: var(--vp-c-warning-soft);
+  --vp-badge-warning-border: transparent;
+  --vp-badge-warning-text: var(--vp-c-warning-1);
+  --vp-badge-warning-bg: var(--vp-c-warning-soft);
 
-   --vp-badge-danger-border: transparent;
-   --vp-badge-danger-text: var(--vp-c-danger-1);
-   --vp-badge-danger-bg: var(--vp-c-danger-soft);
- }
- ```
+  --vp-badge-danger-border: transparent;
+  --vp-badge-danger-text: var(--vp-c-danger-1);
+  --vp-badge-danger-bg: var(--vp-c-danger-soft);
+}
+```
 
 ## `<Badge>`
 
 `<Badge>` コンポーネントは次の props を受け取ります。
 
- ```ts
- interface Props {
-   // `<slot>` が渡された場合、この値は無視されます。
-   text?: string
+```ts
+interface Props {
+  // `<slot>` が渡された場合、この値は無視されます。
+  text?: string
 
-   // 既定値は `tip`。
-   type?: 'info' | 'tip' | 'warning' | 'danger'
- }
- ```
+  // 既定値は `tip`。
+  type?: 'info' | 'tip' | 'warning' | 'danger'
+}
+```
diff --git a/docs/ja/reference/default-theme-carbon-ads.md b/docs/ja/reference/default-theme-carbon-ads.md
index 222c80b3..42d6329b 100644
--- a/docs/ja/reference/default-theme-carbon-ads.md
+++ b/docs/ja/reference/default-theme-carbon-ads.md
@@ -2,21 +2,21 @@
 
 VitePress は [Carbon Ads](https://www.carbonads.net/) をネイティブにサポートしています。設定で Carbon Ads の認証情報を定義すると、ページ上に広告が表示されます。
 
- ```js
- export default {
-   themeConfig: {
-     carbonAds: {
-       code: 'your-carbon-code',
-       placement: 'your-carbon-placement'
-     }
-   }
- }
- ```
+```js
+export default {
+  themeConfig: {
+    carbonAds: {
+      code: 'your-carbon-code',
+      placement: 'your-carbon-placement'
+    }
+  }
+}
+```
 
 これらの値は、次のように Carbon の CDN スクリプトを呼び出すために使用されます。
 
- ```js
- `//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
- ```
+```js
+`//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
+```
 
 Carbon Ads の設定について詳しくは、[Carbon Ads のウェブサイト](https://www.carbonads.net/)を参照してください。
diff --git a/docs/ja/reference/default-theme-config.md b/docs/ja/reference/default-theme-config.md
index bb37d13a..7fe4cc48 100644
--- a/docs/ja/reference/default-theme-config.md
+++ b/docs/ja/reference/default-theme-config.md
@@ -2,20 +2,20 @@
 
 テーマ設定では、テーマのカスタマイズができます。設定ファイルの `themeConfig` オプションで定義します。
 
- ```ts
- export default {
-   lang: 'en-US',
-   title: 'VitePress',
-   description: 'Vite & Vue powered static site generator.',
-
-   // テーマ関連の設定
-   themeConfig: {
-     logo: '/logo.svg',
-     nav: [...],
-     sidebar: { ... }
-   }
- }
- ```
+```ts
+export default {
+  lang: 'en-US',
+  title: 'VitePress',
+  description: 'Vite & Vue powered static site generator.',
+
+  // テーマ関連の設定
+  themeConfig: {
+    logo: '/logo.svg',
+    nav: [...],
+    sidebar: { ... }
+  }
+}
+```
 
 **このページで説明するオプションは、デフォルトテーマにのみ適用されます。** テーマによって期待する設定は異なります。カスタムテーマを使用する場合、ここで定義したテーマ設定オブジェクトはテーマへ渡され、テーマ側がそれに基づいて条件付きの挙動を定義できます。
 
@@ -31,20 +31,20 @@
 
 サイトタイトルの直前に、ナビゲーションバーに表示されるロゴ。パス文字列、またはライト／ダークモードで異なるロゴを設定するオブジェクトを受け取ります。
 
- ```ts
- export default {
-   themeConfig: {
-     logo: '/logo.svg'
-   }
- }
- ```
-
- ```ts
- type ThemeableImage =
-   | string
-   | { src: string; alt?: string }
-   | { light: string; dark: string; alt?: string }
- ```
+```ts
+export default {
+  themeConfig: {
+    logo: '/logo.svg'
+  }
+}
+```
+
+```ts
+type ThemeableImage =
+  | string
+  | { src: string; alt?: string }
+  | { light: string; dark: string; alt?: string }
+```
 
 ## siteTitle
 
@@ -52,13 +52,13 @@
 
 ナビゲーション内の既定サイトタイトル（アプリ設定の `title`）を置き換えます。`false` の場合、ナビのタイトルを非表示にします。ロゴ自体にサイト名が含まれている場合に便利です。
 
- ```ts
- export default {
-   themeConfig: {
-     siteTitle: 'Hello World'
-   }
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    siteTitle: 'Hello World'
+  }
+}
+```
 
 ## nav
 
@@ -66,47 +66,47 @@
 
 ナビゲーションメニューの設定。[デフォルトテーマ: ナビ](./default-theme-nav#navigation-links) を参照してください。
 
- ```ts
- export default {
-   themeConfig: {
-     nav: [
-       { text: 'Guide', link: '/guide' },
-       {
-         text: 'Dropdown Menu',
-         items: [
-           { text: 'Item A', link: '/item-1' },
-           { text: 'Item B', link: '/item-2' },
-           { text: 'Item C', link: '/item-3' }
-         ]
-       }
-     ]
-   }
- }
- ```
-
- ```ts
- type NavItem = NavItemWithLink | NavItemWithChildren
-
- interface NavItemWithLink {
-   text: string
-   link: string | ((payload: PageData) => string)
-   activeMatch?: string
-   target?: string
-   rel?: string
-   noIcon?: boolean
- }
-
- interface NavItemChildren {
-   text?: string
-   items: NavItemWithLink[]
- }
-
- interface NavItemWithChildren {
-   text?: string
-   items: (NavItemChildren | NavItemWithLink)[]
-   activeMatch?: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    nav: [
+      { text: 'Guide', link: '/guide' },
+      {
+        text: 'Dropdown Menu',
+        items: [
+          { text: 'Item A', link: '/item-1' },
+          { text: 'Item B', link: '/item-2' },
+          { text: 'Item C', link: '/item-3' }
+        ]
+      }
+    ]
+  }
+}
+```
+
+```ts
+type NavItem = NavItemWithLink | NavItemWithChildren
+
+interface NavItemWithLink {
+  text: string
+  link: string | ((payload: PageData) => string)
+  activeMatch?: string
+  target?: string
+  rel?: string
+  noIcon?: boolean
+}
+
+interface NavItemChildren {
+  text?: string
+  items: NavItemWithLink[]
+}
+
+interface NavItemWithChildren {
+  text?: string
+  items: (NavItemChildren | NavItemWithLink)[]
+  activeMatch?: string
+}
+```
 
 ## sidebar
 
@@ -114,69 +114,69 @@
 
 サイドバーメニューの設定。[デフォルトテーマ: サイドバー](./default-theme-sidebar) を参照してください。
 
- ```ts
- export default {
-   themeConfig: {
-     sidebar: [
-       {
-         text: 'Guide',
-         items: [
-           { text: 'Introduction', link: '/introduction' },
-           { text: 'Getting Started', link: '/getting-started' },
-           ...
-         ]
-       }
-     ]
-   }
- }
- ```
-
- ```ts
- export type Sidebar = SidebarItem[] | SidebarMulti
-
- export interface SidebarMulti {
-   [path: string]: SidebarItem[] | { items: SidebarItem[]; base: string }
- }
-
- export type SidebarItem = {
-   /**
-    * 項目のテキストラベル
-    */
-   text?: string
-
-   /**
-    * 項目のリンク
-    */
-   link?: string
-
-   /**
-    * 子項目
-    */
-   items?: SidebarItem[]
-
-   /**
-    * 指定しない場合、グループは折りたたみ不可。
-    *
-    * `true` なら折りたたみ可能でデフォルト折りたたみ
-    *
-    * `false` なら折りたたみ可能だがデフォルト展開
-    */
-   collapsed?: boolean
-
-   /**
-    * 子項目のベースパス
-    */
-   base?: string
-
-   /**
-    * 前／次リンクのフッターに表示するテキストをカスタマイズ
-    */
-   docFooterText?: string
-
-   rel?: string
-   target?: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    sidebar: [
+      {
+        text: 'Guide',
+        items: [
+          { text: 'Introduction', link: '/introduction' },
+          { text: 'Getting Started', link: '/getting-started' },
+          ...
+        ]
+      }
+    ]
+  }
+}
+```
+
+```ts
+export type Sidebar = SidebarItem[] | SidebarMulti
+
+export interface SidebarMulti {
+  [path: string]: SidebarItem[] | { items: SidebarItem[]; base: string }
+}
+
+export type SidebarItem = {
+  /**
+   * 項目のテキストラベル
+   */
+  text?: string
+
+  /**
+   * 項目のリンク
+   */
+  link?: string
+
+  /**
+   * 子項目
+   */
+  items?: SidebarItem[]
+
+  /**
+   * 指定しない場合、グループは折りたたみ不可。
+   *
+   * `true` なら折りたたみ可能でデフォルト折りたたみ
+   *
+   * `false` なら折りたたみ可能だがデフォルト展開
+   */
+  collapsed?: boolean
+
+  /**
+   * 子項目のベースパス
+   */
+  base?: string
+
+  /**
+   * 前／次リンクのフッターに表示するテキストをカスタマイズ
+   */
+  docFooterText?: string
+
+  rel?: string
+  target?: string
+}
+```
 
 ## aside
 
@@ -197,26 +197,26 @@
 
 `false` でアウトラインコンテナの描画を無効化。詳細は以下を参照：
 
- ```ts
- interface Outline {
-   /**
-    * アウトラインに表示する見出しレベル
-    * 単一の数値なら、そのレベルのみ表示
-    * タプルなら最小レベルと最大レベル
-    * `'deep'` は `[2, 6]` と同じ（`<h2>` 〜 `<h6>` を表示）
-    *
-    * @default 2
-    */
-   level?: number | [number, number] | 'deep'
-
-   /**
-    * アウトラインに表示するタイトル
-    *
-    * @default 'On this page'
-    */
-   label?: string
- }
- ```
+```ts
+interface Outline {
+  /**
+   * アウトラインに表示する見出しレベル
+   * 単一の数値なら、そのレベルのみ表示
+   * タプルなら最小レベルと最大レベル
+   * `'deep'` は `[2, 6]` と同じ（`<h2>` 〜 `<h6>` を表示）
+   *
+   * @default 2
+   */
+  level?: number | [number, number] | 'deep'
+
+  /**
+   * アウトラインに表示するタイトル
+   *
+   * @default 'On this page'
+   */
+  label?: string
+}
+```
 
 ## socialLinks
 
@@ -224,34 +224,34 @@
 
 ナビゲーションにアイコン付きのソーシャルリンクを表示します。
 
- ```ts
- export default {
-   themeConfig: {
-     socialLinks: [
-       // simple-icons (https://simpleicons.org/) の任意のアイコンを指定可能
-       { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
-       { icon: 'twitter', link: '...' },
-       // SVG 文字列を渡してカスタムアイコンも可
-       {
-         icon: {
-           svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Dribbble</title><path d="M12...6.38z"/></svg>'
-         },
-         link: '...',
-         // アクセシビリティ向けにカスタムラベルも指定可（推奨）
-         ariaLabel: 'cool link'
-       }
-     ]
-   }
- }
- ```
-
- ```ts
- interface SocialLink {
-   icon: string | { svg: string }
-   link: string
-   ariaLabel?: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    socialLinks: [
+      // simple-icons (https://simpleicons.org/) の任意のアイコンを指定可能
+      { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
+      { icon: 'twitter', link: '...' },
+      // SVG 文字列を渡してカスタムアイコンも可
+      {
+        icon: {
+          svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Dribbble</title><path d="M12...6.38z"/></svg>'
+        },
+        link: '...',
+        // アクセシビリティ向けにカスタムラベルも指定可（推奨）
+        ariaLabel: 'cool link'
+      }
+    ]
+  }
+}
+```
+
+```ts
+interface SocialLink {
+  icon: string | { svg: string }
+  link: string
+  ariaLabel?: string
+}
+```
 
 ## footer
 
@@ -260,23 +260,23 @@
 
 フッター設定。メッセージや著作権表示を追加できますが、ページにサイドバーがある場合はデザイン上表示されません。
 
- ```ts
- export default {
-   themeConfig: {
-     footer: {
-       message: 'Released under the MIT License.',
-       copyright: 'Copyright © 2019-present Evan You'
-     }
-   }
- }
- ```
-
- ```ts
- export interface Footer {
-   message?: string
-   copyright?: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    footer: {
+      message: 'Released under the MIT License.',
+      copyright: 'Copyright © 2019-present Evan You'
+    }
+  }
+}
+```
+
+```ts
+export interface Footer {
+  message?: string
+  copyright?: string
+}
+```
 
 ## editLink
 
@@ -285,23 +285,23 @@
 
 「このページを編集」リンクを表示します（GitHub/GitLab など）。詳細は [デフォルトテーマ: 編集リンク](./default-theme-edit-link) を参照。
 
- ```ts
- export default {
-   themeConfig: {
-     editLink: {
-       pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
-       text: 'Edit this page on GitHub'
-     }
-   }
- }
- ```
-
- ```ts
- export interface EditLink {
-   pattern: string
-   text?: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    editLink: {
+      pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+      text: 'Edit this page on GitHub'
+    }
+  }
+}
+```
+
+```ts
+export interface EditLink {
+  pattern: string
+  text?: string
+}
+```
 
 ## lastUpdated
 
@@ -309,34 +309,34 @@
 
 最終更新の文言と日付フォーマットをカスタマイズします。
 
- ```ts
- export default {
-   themeConfig: {
-     lastUpdated: {
-       text: 'Updated at',
-       formatOptions: {
-         dateStyle: 'full',
-         timeStyle: 'medium'
-       }
-     }
-   }
- }
- ```
-
- ```ts
- export interface LastUpdatedOptions {
-   /**
-    * @default 'Last updated'
-    */
-   text?: string
-
-   /**
-    * @default
-    * { dateStyle: 'short',  timeStyle: 'short' }
-    */
-   formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean }
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    lastUpdated: {
+      text: 'Updated at',
+      formatOptions: {
+        dateStyle: 'full',
+        timeStyle: 'medium'
+      }
+    }
+  }
+}
+```
+
+```ts
+export interface LastUpdatedOptions {
+  /**
+   * @default 'Last updated'
+   */
+  text?: string
+
+  /**
+   * @default
+   * { dateStyle: 'short',  timeStyle: 'short' }
+   */
+  formatOptions?: Intl.DateTimeFormatOptions & { forceLocale?: boolean }
+}
+```
 
 ## algolia
 
@@ -344,11 +344,11 @@
 
 [Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch) によるサイト内検索の設定。[デフォルトテーマ: 検索](./default-theme-search) を参照。
 
- ```ts
- export interface AlgoliaSearchOptions extends DocSearchProps {
-   locales?: Record<string, Partial<DocSearchProps>>
- }
- ```
+```ts
+export interface AlgoliaSearchOptions extends DocSearchProps {
+  locales?: Record<string, Partial<DocSearchProps>>
+}
+```
 
 完全なオプションは[こちら](https://github.com/vuejs/vitepress/blob/main/types/docsearch.d.ts)。
 
@@ -358,23 +358,23 @@
 
 [Carbon Ads](https://www.carbonads.net/) を表示します。
 
- ```ts
- export default {
-   themeConfig: {
-     carbonAds: {
-       code: 'your-carbon-code',
-       placement: 'your-carbon-placement'
-     }
-   }
- }
- ```
-
- ```ts
- export interface CarbonAdsOptions {
-   code: string
-   placement: string
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    carbonAds: {
+      code: 'your-carbon-code',
+      placement: 'your-carbon-placement'
+    }
+  }
+}
+```
+
+```ts
+export interface CarbonAdsOptions {
+  code: string
+  placement: string
+}
+```
 
 詳細は [デフォルトテーマ: Carbon Ads](./default-theme-carbon-ads) を参照。
 
@@ -384,23 +384,23 @@
 
 前／次リンクの上に表示される文言をカスタマイズします。英語以外のドキュメントで便利。前／次リンク自体をグローバルに無効化することも可能。ページごとに切り替えたい場合は [frontmatter](./default-theme-prev-next-links) を使用します。
 
- ```ts
- export default {
-   themeConfig: {
-     docFooter: {
-       prev: 'Pagina prior',
-       next: 'Proxima pagina'
-     }
-   }
- }
- ```
-
- ```ts
- export interface DocFooter {
-   prev?: string | false
-   next?: string | false
- }
- ```
+```ts
+export default {
+  themeConfig: {
+    docFooter: {
+      prev: 'Pagina prior',
+      next: 'Proxima pagina'
+    }
+  }
+}
+```
+
+```ts
+export interface DocFooter {
+  prev?: string | false
+  next?: string | false
+}
+```
 
 ## darkModeSwitchLabel
 
@@ -462,33 +462,33 @@ Markdown 内の外部リンクの横に外部リンクアイコンを表示す
 
 レイアウト関連のデータを返します。返り値の型は次のとおりです。
 
- ```ts
- interface {
-   isHome: ComputedRef<boolean>
+```ts
+interface {
+  isHome: ComputedRef<boolean>
 
-   sidebar: Readonly<ShallowRef<DefaultTheme.SidebarItem[]>>
-   sidebarGroups: ComputedRef<DefaultTheme.SidebarItem[]>
-   hasSidebar: ComputedRef<boolean>
-   isSidebarEnabled: ComputedRef<boolean>
+  sidebar: Readonly<ShallowRef<DefaultTheme.SidebarItem[]>>
+  sidebarGroups: ComputedRef<DefaultTheme.SidebarItem[]>
+  hasSidebar: ComputedRef<boolean>
+  isSidebarEnabled: ComputedRef<boolean>
 
-   hasAside: ComputedRef<boolean>
-   leftAside: ComputedRef<boolean>
+  hasAside: ComputedRef<boolean>
+  leftAside: ComputedRef<boolean>
 
-   headers: Readonly<ShallowRef<DefaultTheme.OutlineItem[]>>
-   hasLocalNav: ComputedRef<boolean>
- }
- ```
+  headers: Readonly<ShallowRef<DefaultTheme.OutlineItem[]>>
+  hasLocalNav: ComputedRef<boolean>
+}
+```
 
 **例:**
 
- ```vue
- <script setup>
- import { useLayout } from 'vitepress/theme'
+```vue
+<script setup>
+import { useLayout } from 'vitepress/theme'
 
- const { hasSidebar } = useLayout()
- </script>
+const { hasSidebar } = useLayout()
+</script>
 
- <template>
-   <div v-if="hasSidebar">サイドバーがあるときだけ表示</div>
- </template>
- ```
+<template>
+  <div v-if="hasSidebar">サイドバーがあるときだけ表示</div>
+</template>
+```
diff --git a/docs/ja/reference/default-theme-edit-link.md b/docs/ja/reference/default-theme-edit-link.md
index 03573944..a5b40dbd 100644
--- a/docs/ja/reference/default-theme-edit-link.md
+++ b/docs/ja/reference/default-theme-edit-link.md
@@ -4,57 +4,57 @@
 
 編集リンクは、GitHub や GitLab などの Git 管理サービスでそのページを編集できるリンクを表示します。有効化するには、設定に `themeConfig.editLink` オプションを追加します。
 
- ```js
- export default {
-   themeConfig: {
-     editLink: {
-       pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path'
-     }
-   }
- }
- ```
+```js
+export default {
+  themeConfig: {
+    editLink: {
+      pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path'
+    }
+  }
+}
+```
 
 `pattern` オプションはリンクの URL 構造を定義します。`:path` はページパスに置き換えられます。
 
 また、引数に [`PageData`](./runtime-api#usedata) を受け取り、URL 文字列を返す純粋関数を指定することもできます。
 
- ```js
- export default {
-   themeConfig: {
-     editLink: {
-       pattern: ({ filePath }) => {
-         if (filePath.startsWith('packages/')) {
-           return `https://github.com/acme/monorepo/edit/main/${filePath}`
-         } else {
-           return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
-         }
-       }
-     }
-   }
- }
- ```
+```js
+export default {
+  themeConfig: {
+    editLink: {
+      pattern: ({ filePath }) => {
+        if (filePath.startsWith('packages/')) {
+          return `https://github.com/acme/monorepo/edit/main/${filePath}`
+        } else {
+          return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
+        }
+      }
+    }
+  }
+}
+```
 
 この関数はブラウザでシリアライズされ実行されるため、副作用を持たず、スコープ外のものへアクセスしないでください。
 
 既定では、ドキュメント下部に「Edit this page」というリンクテキストが表示されます。`text` オプションでこの文言をカスタマイズできます。
 
- ```js
- export default {
-   themeConfig: {
-     editLink: {
-       pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
-       text: 'GitHub でこのページを編集'
-     }
-   }
- }
- ```
+```js
+export default {
+  themeConfig: {
+    editLink: {
+      pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
+      text: 'GitHub でこのページを編集'
+    }
+  }
+}
+```
 
 ## フロントマターでの設定 {#frontmatter-config}
 
 ページごとに無効化するには、フロントマターで `editLink` オプションを使用します。
 
- ```yaml
- ---
- editLink: false
- ---
- ```
+```yaml
+---
+editLink: false
+---
+```
diff --git a/docs/ja/reference/default-theme-home-page.md b/docs/ja/reference/default-theme-home-page.md
index e472a478..011456f8 100644
--- a/docs/ja/reference/default-theme-home-page.md
+++ b/docs/ja/reference/default-theme-home-page.md
@@ -186,3 +186,4 @@ hero:
 npm init
 npx vitepress init
 ```
+````
diff --git a/docs/ja/reference/default-theme-search.md b/docs/ja/reference/default-theme-search.md
index 70837c10..f7760361 100644
--- a/docs/ja/reference/default-theme-search.md
+++ b/docs/ja/reference/default-theme-search.md
@@ -179,7 +179,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/ja/reference/runtime-api.md b/docs/ja/reference/runtime-api.md
index b73b8503..afcad68d 100644
--- a/docs/ja/reference/runtime-api.md
+++ b/docs/ja/reference/runtime-api.md
@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/ko/reference/default-theme-search.md b/docs/ko/reference/default-theme-search.md
index 739d2dcc..0ee68e36 100644
--- a/docs/ko/reference/default-theme-search.md
+++ b/docs/ko/reference/default-theme-search.md
@@ -174,7 +174,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/ko/reference/runtime-api.md b/docs/ko/reference/runtime-api.md
index e9a8e530..ee7a4ba3 100644
--- a/docs/ko/reference/runtime-api.md
+++ b/docs/ko/reference/runtime-api.md
@@ -49,7 +49,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/pt/reference/default-theme-search.md b/docs/pt/reference/default-theme-search.md
index b83569c9..44c5b8ac 100644
--- a/docs/pt/reference/default-theme-search.md
+++ b/docs/pt/reference/default-theme-search.md
@@ -174,7 +174,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/pt/reference/runtime-api.md b/docs/pt/reference/runtime-api.md
index ed6476ac..559e2fed 100644
--- a/docs/pt/reference/runtime-api.md
+++ b/docs/pt/reference/runtime-api.md
@@ -45,7 +45,7 @@ interface PageData {
   titleTemplate?: string | boolean
   description: string
   relativePath: string
-  filePath: string,
+  filePath: string
   headers: Header[]
   frontmatter: Record<string, any>
   params?: Record<string, any>
diff --git a/docs/ru/reference/default-theme-search.md b/docs/ru/reference/default-theme-search.md
index c4ea2b1c..16bad58d 100644
--- a/docs/ru/reference/default-theme-search.md
+++ b/docs/ru/reference/default-theme-search.md
@@ -179,7 +179,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }
diff --git a/docs/zh/reference/default-theme-search.md b/docs/zh/reference/default-theme-search.md
index 89d8cb89..a95c907a 100644
--- a/docs/zh/reference/default-theme-search.md
+++ b/docs/zh/reference/default-theme-search.md
@@ -174,7 +174,7 @@ export default defineConfig({
         async _render(src, env, md) {
           const html = await md.renderAsync(src, env)
           if (env.frontmatter?.title)
-            return await md.renderAsync(`# ${env.frontmatter.title}`) + html
+            return (await md.renderAsync(`# ${env.frontmatter.title}`)) + html
           return html
         }
       }

From fb21fdf6759b7c88ac98456820b75286936fbf87 Mon Sep 17 00:00:00 2001
From: Divyansh Singh <40380293+brc-dd@users.noreply.github.com>
Date: Wed, 4 Feb 2026 19:40:03 +0530
Subject: [PATCH 2/2] fix: `processIncludes` no longer swallows errors

**BREAKING CHANGE:**
The previous `<!-- @include: ./path/to/file -->` syntax silently ignored errors when files did not exist. This behavior was originally intended as an escape hatch while documenting includes, but better solutions now exist using Shiki transformers.

For most users, no code changes are required. If you now see errors, it means your includes are broken and were previously not being reported.

Users who intentionally reference non-existent files or want to document includes without resolving them can configure `markdown.codeTransformers` with a `postprocess` hook. See `docs/.vitepress/config.ts` in this repo for an example.
---
 docs/.vitepress/config.ts         |   7 +-
 docs/en/guide/markdown.md         |  12 +--
 docs/es/guide/markdown.md         |   4 +-
 docs/fa/guide/markdown.md         |   8 +-
 docs/ja/guide/markdown.md         |  12 +--
 docs/ko/guide/markdown.md         |   8 +-
 docs/pt/guide/markdown.md         |   4 +-
 docs/ru/guide/markdown.md         |  12 +--
 docs/zh/guide/markdown.md         |   4 +-
 src/node/utils/processIncludes.ts | 119 ++++++++++++++----------------
 10 files changed, 92 insertions(+), 98 deletions(-)

diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
index 7a6626c9..4b1eb23a 100644
--- a/docs/.vitepress/config.ts
+++ b/docs/.vitepress/config.ts
@@ -26,10 +26,13 @@ export default defineConfig({
   markdown: {
     math: true,
     codeTransformers: [
-      // We use `[!!code` in demo to prevent transformation, here we revert it back.
+      // We use `[!!code` and `@@include` in demo to prevent transformation,
+      // here we revert it back.
       {
         postprocess(code) {
-          return code.replace(/\[\!\!code/g, '[!code')
+          return code
+            .replace(/\[\!\!code/g, '[!code')
+            .replace('@@include', '@include')
         }
       }
     ],
diff --git a/docs/en/guide/markdown.md b/docs/en/guide/markdown.md
index 7249fac2..a60f764e 100644
--- a/docs/en/guide/markdown.md
+++ b/docs/en/guide/markdown.md
@@ -793,7 +793,7 @@ For example, you can include a relative markdown file using this:
 
 ## Basics
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -829,7 +829,7 @@ It also supports selecting a line range:
 
 ## Basics
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -865,8 +865,8 @@ You can also use a [VS Code region](https://code.visualstudio.com/docs/editor/co
 
 ## Basics
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -917,7 +917,7 @@ You can include the `My Base Section` section like this:
 
 ```md
 ## My Extended Section
-<!--@include: ./parts/basics.md#my-base-section-->
+<!--@@include: ./parts/basics.md#my-base-section-->
 ```
 
 **Equivalent code**
@@ -941,7 +941,7 @@ Here, `my-base-section` is the generated id of the heading element. In case it's
 and include it like this:
 
 ```md
-<!--@include: ./parts/basics.md#custom-id-->
+<!--@@include: ./parts/basics.md#custom-id-->
 ```
 
 ## Math Equations
diff --git a/docs/es/guide/markdown.md b/docs/es/guide/markdown.md
index 516f70f3..b76eb0ac 100644
--- a/docs/es/guide/markdown.md
+++ b/docs/es/guide/markdown.md
@@ -773,7 +773,7 @@ Por ejemplo, puede incluir un archivo markdown relativo usando esto:
 
 ## Conceptos Básicos
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Archivo de Parte** (`parts/basics.md`)
@@ -809,7 +809,7 @@ También soporta la selección de un intervalo de lineas:
 
 ## Conceptos Básicos
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Archivo de Parte** (`parts/basics.md`)
diff --git a/docs/fa/guide/markdown.md b/docs/fa/guide/markdown.md
index 077c7383..bac84ac9 100644
--- a/docs/fa/guide/markdown.md
+++ b/docs/fa/guide/markdown.md
@@ -724,7 +724,7 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)
@@ -760,7 +760,7 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)
@@ -796,8 +796,8 @@ export default config
 
 ## مبانی
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **قسمت فایل** (`parts/basics.md`)
diff --git a/docs/ja/guide/markdown.md b/docs/ja/guide/markdown.md
index 97b7c2db..54455823 100644
--- a/docs/ja/guide/markdown.md
+++ b/docs/ja/guide/markdown.md
@@ -794,7 +794,7 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 ## 基本
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **パートファイル**（`parts/basics.md`）
@@ -830,7 +830,7 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 ## 基本
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **パートファイル**（`parts/basics.md`）
@@ -866,8 +866,8 @@ Markdown パスの先頭に `@` を付けることもでき、その場合はソ
 
 ## 基本
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **パートファイル**（`parts/basics.md`）
@@ -919,7 +919,7 @@ VS Code のリージョンの代わりに、ヘッダーアンカーを使って
 ```md
 ## 拡張セクション
 
-<!--@include: ./parts/basics.md#my-base-section-->
+<!--@@include: ./parts/basics.md#my-base-section-->
 ```
 
 **等価なコード**
@@ -943,7 +943,7 @@ VS Code のリージョンの代わりに、ヘッダーアンカーを使って
 そして次のように取り込みます：
 
 ```md
-<!--@include: ./parts/basics.md#custom-id-->
+<!--@@include: ./parts/basics.md#custom-id-->
 ```
 
 ## 数式 {#math-equations}
diff --git a/docs/ko/guide/markdown.md b/docs/ko/guide/markdown.md
index 0ebf53a5..4584d1bd 100644
--- a/docs/ko/guide/markdown.md
+++ b/docs/ko/guide/markdown.md
@@ -771,7 +771,7 @@ export default config
 
 ## Basics
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **해당 파일** (`parts/basics.md`)
@@ -807,7 +807,7 @@ Can be created using `.foorc.json`.
 
 ## Basics
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **해당 파일** (`parts/basics.md`)
@@ -843,8 +843,8 @@ Can be created using `.foorc.json`.
 
 ## Basics
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **해당 파일** (`parts/basics.md`)
diff --git a/docs/pt/guide/markdown.md b/docs/pt/guide/markdown.md
index a300585c..bfcc591f 100644
--- a/docs/pt/guide/markdown.md
+++ b/docs/pt/guide/markdown.md
@@ -771,7 +771,7 @@ Por exemplo, você pode incluir um arquivo markdown relativo usando isto:
 
 ## Conceitos Básicos
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Arquivo da Parte** (`parts/basics.md`)
@@ -807,7 +807,7 @@ Também suporta a seleção de um intervalo de linhas:
 
 ## Conceitos Básicos
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Arquivo da Parte** (`parts/basics.md`)
diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md
index a7413885..6e0cd567 100644
--- a/docs/ru/guide/markdown.md
+++ b/docs/ru/guide/markdown.md
@@ -795,7 +795,7 @@ export default config
 
 ## Основы
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Файл части** (`parts/basics.md`)
@@ -831,7 +831,7 @@ export default config
 
 ## Основы
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Файл части** (`parts/basics.md`)
@@ -867,8 +867,8 @@ export default config
 
 ## Основы
 
-<!--@include: ./parts/basics.md#basic-usage{,2}-->
-<!--@include: ./parts/basics.md#basic-usage{5,}-->
+<!--@@include: ./parts/basics.md#basic-usage{,2}-->
+<!--@@include: ./parts/basics.md#basic-usage{5,}-->
 ```
 
 **Часть файла** (`parts/basics.md`)
@@ -919,7 +919,7 @@ export default config
 
 ```md
 ## Мой дополнительный раздел
-<!--@include: ./parts/basics.md#мои-основнои-раздел-->
+<!--@@include: ./parts/basics.md#мои-основнои-раздел-->
 ```
 
 **Соответствующий код**
@@ -943,7 +943,7 @@ export default config
 и включить его следующим образом:
 
 ```md
-<!--@include: ./parts/basics.md#custom-id-->
+<!--@@include: ./parts/basics.md#custom-id-->
 ```
 
 ## Математические уравнения {#math-equations}
diff --git a/docs/zh/guide/markdown.md b/docs/zh/guide/markdown.md
index aaad599f..8f469468 100644
--- a/docs/zh/guide/markdown.md
+++ b/docs/zh/guide/markdown.md
@@ -771,7 +771,7 @@ export default config
 
 ## Basics
 
-<!--@include: ./parts/basics.md-->
+<!--@@include: ./parts/basics.md-->
 ```
 
 **Part file** (`parts/basics.md`)
@@ -807,7 +807,7 @@ Can be created using `.foorc.json`.
 
 ## Basics
 
-<!--@include: ./parts/basics.md{3,}-->
+<!--@@include: ./parts/basics.md{3,}-->
 ```
 
 **Part file** (`parts/basics.md`)
diff --git a/src/node/utils/processIncludes.ts b/src/node/utils/processIncludes.ts
index aa98ccbd..20f6fbff 100644
--- a/src/node/utils/processIncludes.ts
+++ b/src/node/utils/processIncludes.ts
@@ -1,8 +1,7 @@
-import fs from 'fs-extra'
 import matter from 'gray-matter'
 import type { MarkdownItAsync } from 'markdown-it-async'
+import fs from 'node:fs'
 import path from 'node:path'
-import c from 'picocolors'
 import { findRegion } from '../markdown/plugins/snippet'
 import { slash, type MarkdownEnv } from '../shared'
 
@@ -33,78 +32,70 @@ export function processIncludes(
 
     const atPresent = m1[0] === '@'
 
-    try {
-      const includePath = atPresent
-        ? path.join(srcDir, m1.slice(m1[1] === '/' ? 2 : 1))
-        : path.join(path.dirname(file), m1)
-      let content = fs.readFileSync(includePath, 'utf-8')
+    const includePath = atPresent
+      ? path.join(srcDir, m1.slice(m1[1] === '/' ? 2 : 1))
+      : path.join(path.dirname(file), m1)
 
-      if (region) {
-        const [regionName] = region
-        const lines = content.split(/\r?\n/)
-        let { start, end } = findRegion(lines, regionName.slice(1)) ?? {}
+    let content = fs.readFileSync(includePath, 'utf-8')
 
-        if (start === undefined) {
-          // region not found, it might be a header
-          const tokens = md
-            .parse(content, {
-              path: includePath,
-              relativePath: slash(path.relative(srcDir, includePath)),
-              cleanUrls
-            } satisfies MarkdownEnv)
-            .filter((t) => t.type === 'heading_open' && t.map)
-          const idx = tokens.findIndex(
-            (t) => t.attrGet('id') === regionName.slice(1)
-          )
-          const token = tokens[idx]
-          if (token) {
-            start = token.map![1]
-            const level = parseInt(token.tag.slice(1))
-            for (let i = idx + 1; i < tokens.length; i++) {
-              if (parseInt(tokens[i].tag.slice(1)) <= level) {
-                end = tokens[i].map![0]
-                break
-              }
+    if (region) {
+      const [regionName] = region
+      const lines = content.split(/\r?\n/)
+      let { start, end } = findRegion(lines, regionName.slice(1)) ?? {}
+
+      if (start === undefined) {
+        // region not found, it might be a header
+        const tokens = md
+          .parse(content, {
+            path: includePath,
+            relativePath: slash(path.relative(srcDir, includePath)),
+            cleanUrls
+          } satisfies MarkdownEnv)
+          .filter((t) => t.type === 'heading_open' && t.map)
+        const idx = tokens.findIndex(
+          (t) => t.attrGet('id') === regionName.slice(1)
+        )
+        const token = tokens[idx]
+        if (token) {
+          start = token.map![1]
+          const level = parseInt(token.tag.slice(1))
+          for (let i = idx + 1; i < tokens.length; i++) {
+            if (parseInt(tokens[i].tag.slice(1)) <= level) {
+              end = tokens[i].map![0]
+              break
             }
           }
         }
-
-        content = lines.slice(start, end).join('\n')
       }
 
-      if (range) {
-        const [, startLine, endLine] = range
-        const lines = content.split(/\r?\n/)
-        content = lines
-          .slice(
-            startLine ? parseInt(startLine) - 1 : undefined,
-            endLine ? parseInt(endLine) : undefined
-          )
-          .join('\n')
-      }
+      content = lines.slice(start, end).join('\n')
+    }
 
-      if (!hasMeta && path.extname(includePath) === '.md') {
-        content = matter(content).content
-      }
+    if (range) {
+      const [, startLine, endLine] = range
+      const lines = content.split(/\r?\n/)
+      content = lines
+        .slice(
+          startLine ? parseInt(startLine) - 1 : undefined,
+          endLine ? parseInt(endLine) : undefined
+        )
+        .join('\n')
+    }
 
-      includes.push(slash(includePath))
-      // recursively process includes in the content
-      return processIncludes(
-        md,
-        srcDir,
-        content,
-        includePath,
-        includes,
-        cleanUrls
-      )
+    if (!hasMeta && path.extname(includePath) === '.md') {
+      content = matter(content).content
+    }
 
-      //
-    } catch (error) {
-      if (process.env.DEBUG) {
-        process.stderr.write(c.yellow(`\nInclude file not found: ${m1}`))
-      }
+    includes.push(slash(includePath))
 
-      return m // silently ignore error if file is not present
-    }
+    // recursively process includes in the content
+    return processIncludes(
+      md,
+      srcDir,
+      content,
+      includePath,
+      includes,
+      cleanUrls
+    )
   })
 }