From 0d591a39453acfb9df0a318406ace02b66864c2d Mon Sep 17 00:00:00 2001
From: "Mr.Hope" <mister-hope@outlook.com>
Date: Fri, 8 Dec 2023 19:07:04 +0800
Subject: [PATCH] feat: use prettier to lint docs

---
 .prettierignore                               | 11 ++++-
 docs/.vuepress/public/new.html                |  4 +-
 .../advanced/cookbook/markdown-and-vue-sfc.md | 15 +++----
 .../cookbook/passing-data-to-client-code.md   |  5 ++-
 docs/advanced/plugin.md                       | 12 +++---
 docs/advanced/theme.md                        |  8 ++--
 docs/guide/assets.md                          |  3 +-
 docs/guide/deployment.md                      |  4 ++
 docs/guide/markdown.md                        | 28 ++++++++++---
 docs/guide/page.md                            |  2 +-
 docs/guide/plugin.md                          |  4 +-
 docs/reference/cli.md                         | 40 +++++++++----------
 docs/reference/components.md                  |  1 +
 docs/reference/default-theme/components.md    |  2 +
 docs/reference/default-theme/extending.md     | 10 ++++-
 docs/reference/default-theme/markdown.md      | 12 ++++++
 docs/reference/frontmatter.md                 | 22 +++++-----
 docs/reference/plugin-api.md                  | 17 ++++----
 docs/reference/plugin/back-to-top.md          |  4 +-
 docs/reference/plugin/container.md            |  4 +-
 docs/reference/plugin/docsearch.md            |  2 +-
 docs/reference/plugin/medium-zoom.md          |  2 +-
 docs/reference/plugin/nprogress.md            |  4 +-
 docs/reference/plugin/palette.md              |  9 +++--
 docs/reference/plugin/pwa.md                  |  2 +-
 docs/reference/plugin/theme-data.md           |  2 +-
 docs/reference/plugin/toc.md                  |  5 ++-
 .../cookbook/passing-data-to-client-code.md   |  5 ++-
 docs/zh/advanced/plugin.md                    | 12 +++---
 docs/zh/advanced/theme.md                     |  8 ++--
 docs/zh/guide/assets.md                       |  3 +-
 docs/zh/guide/deployment.md                   |  4 ++
 docs/zh/guide/markdown.md                     | 31 ++++++++++----
 docs/zh/guide/page.md                         |  4 +-
 docs/zh/guide/plugin.md                       |  4 +-
 docs/zh/reference/cli.md                      | 40 +++++++++----------
 docs/zh/reference/components.md               |  1 +
 docs/zh/reference/default-theme/components.md |  2 +
 docs/zh/reference/default-theme/extending.md  | 10 ++++-
 docs/zh/reference/default-theme/markdown.md   | 12 ++++++
 docs/zh/reference/frontmatter.md              | 22 +++++-----
 docs/zh/reference/node-api.md                 | 33 ++++++++-------
 docs/zh/reference/plugin-api.md               | 12 +++---
 docs/zh/reference/plugin/back-to-top.md       |  4 +-
 docs/zh/reference/plugin/container.md         |  4 +-
 docs/zh/reference/plugin/nprogress.md         |  4 +-
 docs/zh/reference/plugin/palette.md           |  9 +++--
 docs/zh/reference/plugin/pwa.md               |  6 +--
 docs/zh/reference/plugin/theme-data.md        |  2 +-
 docs/zh/reference/plugin/toc.md               |  5 ++-
 package.json                                  |  1 +
 51 files changed, 285 insertions(+), 187 deletions(-)

diff --git a/.prettierignore b/.prettierignore
index 94c9f11d..3c6d5686 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,3 +1,10 @@
+# VuePress files
+docs/.vuepress/.temp/
+docs/.vuepress/.cache/
+docs/.vuepress/dist/
+
+# Node modules
+node_modules/
+
+# pnpm lockfile
 pnpm-lock.yaml
-*.html
-*.md
diff --git a/docs/.vuepress/public/new.html b/docs/.vuepress/public/new.html
index 911989fe..b83ab7cb 100644
--- a/docs/.vuepress/public/new.html
+++ b/docs/.vuepress/public/new.html
@@ -1 +1,3 @@
-<script>window.location = 'https://stackblitz.com/fork/vuepress'</script>
+<script>
+  window.location = 'https://stackblitz.com/fork/vuepress'
+</script>
diff --git a/docs/advanced/cookbook/markdown-and-vue-sfc.md b/docs/advanced/cookbook/markdown-and-vue-sfc.md
index ed4c940f..66f1a57f 100644
--- a/docs/advanced/cookbook/markdown-and-vue-sfc.md
+++ b/docs/advanced/cookbook/markdown-and-vue-sfc.md
@@ -27,13 +27,14 @@ _Current count is: {{ count }}_
 <script setup>
 import { h, ref } from 'vue'
 
-const RedDiv = (_, ctx) => h(
-  'div',
-  {
-    class: 'red-div',
-  },
-  ctx.slots.default()
-)
+const RedDiv = (_, ctx) =>
+  h(
+    'div',
+    {
+      class: 'red-div',
+    },
+    ctx.slots.default(),
+  )
 const msg = 'Vue in Markdown'
 const count = ref(0)
 </script>
diff --git a/docs/advanced/cookbook/passing-data-to-client-code.md b/docs/advanced/cookbook/passing-data-to-client-code.md
index 28407066..39b919b4 100644
--- a/docs/advanced/cookbook/passing-data-to-client-code.md
+++ b/docs/advanced/cookbook/passing-data-to-client-code.md
@@ -43,7 +43,10 @@ First, write a temp file `foo.js`, which will be generated in the [temp](../../r
 export default (options) => ({
   async onPrepared(app) {
     // write temp file
-    await app.writeTemp('foo.js', `export const foo = ${JSON.stringify(options.foo)}`)
+    await app.writeTemp(
+      'foo.js',
+      `export const foo = ${JSON.stringify(options.foo)}`,
+    )
   },
 })
 ```
diff --git a/docs/advanced/plugin.md b/docs/advanced/plugin.md
index e0be81ba..c7e3538f 100644
--- a/docs/advanced/plugin.md
+++ b/docs/advanced/plugin.md
@@ -6,7 +6,7 @@ Before reading this guide, you'd better learn the VuePress [architecture](./arch
 
 ## Create a Plugin
 
-A plugin should be a plain JavaScript object that satisfies the [Plugin API](../reference/plugin-api.md), which is called a *Plugin Object*:
+A plugin should be a plain JavaScript object that satisfies the [Plugin API](../reference/plugin-api.md), which is called a _Plugin Object_:
 
 ```ts
 const fooPlugin = {
@@ -15,7 +15,7 @@ const fooPlugin = {
 }
 ```
 
-A plugin could also be a function that receives the [app instance](../reference/node-api.md#app) as the param and returns a *Plugin Object*, which is called a *Plugin Function*:
+A plugin could also be a function that receives the [app instance](../reference/node-api.md#app) as the param and returns a _Plugin Object_, which is called a _Plugin Function_:
 
 ```ts
 const barPlugin = (app) => {
@@ -26,7 +26,7 @@ const barPlugin = (app) => {
 }
 ```
 
-A plugin usually needs to allow user options, so we typically provide users with a function to receive options, and returns a *Plugin Object* or a *Plugin Function*. Then your plugin should be converted like this:
+A plugin usually needs to allow user options, so we typically provide users with a function to receive options, and returns a _Plugin Object_ or a _Plugin Function_. Then your plugin should be converted like this:
 
 ```ts
 const fooPlugin = (options) => {
@@ -53,11 +53,9 @@ After creating a plugin, you should follow some conventions in the [package.json
 ```json
 {
   "name": "vuepress-plugin-foo",
-  "keywords": [
-    "vuepress-plugin"
-  ]
+  "keywords": ["vuepress-plugin"]
 }
 ```
 
-- Set `name` to follow the naming convention, i.e. `vuepress-plugin-xxx` or `@org/vuepress-plugin-xxx`, which should be consistent with the [name](../reference/plugin-api.md#name) field of the *Plugin Object*.
+- Set `name` to follow the naming convention, i.e. `vuepress-plugin-xxx` or `@org/vuepress-plugin-xxx`, which should be consistent with the [name](../reference/plugin-api.md#name) field of the _Plugin Object_.
 - Set `keywords` to include `vuepress-plugin`, so that users can search your plugin on NPM.
diff --git a/docs/advanced/theme.md b/docs/advanced/theme.md
index bb83bf16..8bfc27aa 100644
--- a/docs/advanced/theme.md
+++ b/docs/advanced/theme.md
@@ -6,7 +6,7 @@ Before reading this guide, you'd better learn the guide of [Writing a Plugin](./
 
 ## Create a Theme
 
-A VuePress theme is a special plugin, which should satisfy the [Theme API](../reference/theme-api.md). Like plugins, a theme should also be a *Theme Object* or a *Theme Function*, and could be wrapped with a function to receive options:
+A VuePress theme is a special plugin, which should satisfy the [Theme API](../reference/theme-api.md). Like plugins, a theme should also be a _Theme Object_ or a _Theme Function_, and could be wrapped with a function to receive options:
 
 ```ts
 import { getDirname, path } from '@vuepress/utils'
@@ -90,11 +90,9 @@ Also, there are some conventions for theme in [package.json](https://docs.npmjs.
 ```json
 {
   "name": "vuepress-theme-foo",
-  "keywords": [
-    "vuepress-theme"
-  ]
+  "keywords": ["vuepress-theme"]
 }
 ```
 
-- Set `name` to follow the naming convention: `vuepress-theme-xxx` or `@org/vuepress-theme-xxx`, which should be consistent with the [name](../reference/theme-api.md#name) field of the *Theme Object*.
+- Set `name` to follow the naming convention: `vuepress-theme-xxx` or `@org/vuepress-theme-xxx`, which should be consistent with the [name](../reference/theme-api.md#name) field of the _Theme Object_.
 - Set `keywords` to include `vuepress-theme`, so that users can search your theme on NPM.
diff --git a/docs/guide/assets.md b/docs/guide/assets.md
index 7d3abb7f..7d9411fe 100644
--- a/docs/guide/assets.md
+++ b/docs/guide/assets.md
@@ -60,6 +60,7 @@ In most cases, you don't need to worry about the reference path of those public
 
 ```md
 <!-- you don't need to prepend `/bar/` to `/images/hero.png` manually -->
+
 ![VuePress Logo](/images/hero.png)
 ```
 
@@ -67,7 +68,7 @@ However, sometimes you may have some dynamical links referencing public files, e
 
 ```vue
 <template>
-  <img :src="withBase(logoPath)">
+  <img :src="withBase(logoPath)" />
 </template>
 
 <script setup>
diff --git a/docs/guide/deployment.md b/docs/guide/deployment.md
index 7f132b68..a59cc2a0 100644
--- a/docs/guide/deployment.md
+++ b/docs/guide/deployment.md
@@ -28,6 +28,7 @@ The following guides are based on some shared assumptions:
    Create `.github/workflows/docs.yml` to set up the workflow.
 
 ::: details Click to expand sample config
+
 ```yaml
 name: docs
 
@@ -81,6 +82,7 @@ jobs:
           # @see https://docs.github.com/en/actions/reference/authentication-in-a-workflow#about-the-github_token-secret
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
+
 :::
 
 ::: tip
@@ -98,6 +100,7 @@ Please refer to [GitHub Pages official guide](https://pages.github.com/) for mor
 2. Create `.gitlab-ci.yml` to set up [GitLab CI](https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/) workflow.
 
 ::: details Click to expand sample config
+
 ```yaml
 # choose a docker image to use
 image: node:18-buster
@@ -129,6 +132,7 @@ pages:
     paths:
       - public
 ```
+
 :::
 
 ::: tip
diff --git a/docs/guide/markdown.md b/docs/guide/markdown.md
index bb594785..7f02d6da 100644
--- a/docs/guide/markdown.md
+++ b/docs/guide/markdown.md
@@ -48,14 +48,19 @@ Take our documentation source files as an example:
 
 ```md
 <!-- relative path -->
+
 [Home](../README.md)  
 [Config Reference](../reference/config.md)  
-[Getting Started](./getting-started.md)  
+[Getting Started](./getting-started.md)
+
 <!-- absolute path -->
+
 [Guide](/guide/README.md)  
-[Config Reference > markdown.links](/reference/config.md#links)  
+[Config Reference > markdown.links](/reference/config.md#links)
+
 <!-- URL -->
-[GitHub](https://github.com)  
+
+[GitHub](https://github.com)
 ```
 
 **Converted to**
@@ -66,8 +71,12 @@ Take our documentation source files as an example:
   <RouterLink to="/reference/config.html">Config Reference</RouterLink>
   <RouterLink to="/guide/getting-started.html">Getting Started</RouterLink>
   <RouterLink to="/guide/">Guide</RouterLink>
-  <RouterLink to="/reference/config.html#links">Config Reference &gt; markdown.links</RouterLink>
-  <a href="https://github.com" target="_blank" rel="noopener noreferrer">GitHub</a>
+  <RouterLink to="/reference/config.html#links"
+    >Config Reference &gt; markdown.links</RouterLink
+  >
+  <a href="https://github.com" target="_blank" rel="noopener noreferrer"
+    >GitHub</a
+  >
 </template>
 ```
 
@@ -78,7 +87,7 @@ Take our documentation source files as an example:
 [Getting Started](./getting-started.md)  
 [Guide](/guide/README.md)  
 [Config Reference > markdown.links](/reference/config.md#links)  
-[GitHub](https://github.com)  
+[GitHub](https://github.com)
 
 **Explanation**
 
@@ -254,6 +263,7 @@ If you want to make Vue syntax work in those languages anyway, try to disable th
 ````md
 ```md
 <!-- This will be kept as is by default -->
+
 1 + 2 + 3 = {{ 1 + 2 + 3 }}
 ```
 
@@ -272,6 +282,7 @@ const onePlusTwoPlusThree = {{ 1 + 2 + 3 }}
 
 ```md
 <!-- This will be kept as is -->
+
 1 + 2 + 3 = {{ 1 + 2 + 3 }}
 ```
 
@@ -302,6 +313,7 @@ You can import code blocks from files with following syntax:
 
 ```md
 <!-- minimal syntax -->
+
 @[code](../foo.js)
 ```
 
@@ -309,6 +321,7 @@ If you want to partially import the file:
 
 ```md
 <!-- partial import, from line 1 to line 10 -->
+
 @[code{1-10}](../foo.js)
 ```
 
@@ -316,6 +329,7 @@ The code language is inferred from the file extension, while it is recommended t
 
 ```md
 <!-- specify the code language -->
+
 @[code js](../foo.js)
 ```
 
@@ -323,6 +337,7 @@ In fact, the second part inside the `[]` will be treated as the mark of the code
 
 ```md
 <!-- line highlighting -->
+
 @[code js{2,4-5}](../foo.js)
 ```
 
@@ -356,6 +371,7 @@ export default {
 
 ```md
 <!-- it will be resolved to 'path/to/src/foo.js' -->
+
 @[code](@src/foo.js)
 ```
 
diff --git a/docs/guide/page.md b/docs/guide/page.md
index 2c627c8a..cd7ed2ab 100644
--- a/docs/guide/page.md
+++ b/docs/guide/page.md
@@ -20,7 +20,7 @@ Assuming this is the directory structure of your markdown files:
 Take the `docs` directory as your [sourceDir](../reference/cli.md), e.g. you are running `vuepress dev docs` command. Then the route paths of your markdown files would be:
 
 | Relative Path               | Route Path                    |
-|-----------------------------|-------------------------------|
+| --------------------------- | ----------------------------- |
 | `/README.md`                | `/`                           |
 | `/index.md`                 | `/`                           |
 | `/contributing.md`          | `/contributing.html`          |
diff --git a/docs/guide/plugin.md b/docs/guide/plugin.md
index 88d48fd0..c7af3767 100644
--- a/docs/guide/plugin.md
+++ b/docs/guide/plugin.md
@@ -38,9 +38,7 @@ But if you have too many things to do in your config file, you can consider to e
 import myPlugin from './path/to/my-plugin.js'
 
 export default {
-  plugins: [
-    myPlugin(),
-  ],
+  plugins: [myPlugin()],
 }
 ```
 
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 19505457..fa325bf7 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -21,8 +21,8 @@ For more info, run any command with the `--help` flag:
   $ vuepress info --help
 
 Options:
-  -v, --version  Display version number 
-  -h, --help     Display this message 
+  -v, --version  Display version number
+  -h, --help     Display this message
 ```
 
 ::: tip
@@ -40,17 +40,17 @@ Usage:
   $ vuepress dev [sourceDir]
 
 Options:
-  -c, --config <config>  Set path to config file 
-  -p, --port <port>      Use specified port (default: 8080) 
-  -t, --temp <temp>      Set the directory of the temporary files 
-  --host <host>          Use specified host (default: 0.0.0.0) 
-  --cache <cache>        Set the directory of the cache files 
-  --clean-temp           Clean the temporary files before dev 
-  --clean-cache          Clean the cache files before dev 
-  --open                 Open browser when ready 
-  --debug                Enable debug mode 
+  -c, --config <config>  Set path to config file
+  -p, --port <port>      Use specified port (default: 8080)
+  -t, --temp <temp>      Set the directory of the temporary files
+  --host <host>          Use specified host (default: 0.0.0.0)
+  --cache <cache>        Set the directory of the cache files
+  --clean-temp           Clean the temporary files before dev
+  --clean-cache          Clean the cache files before dev
+  --open                 Open browser when ready
+  --debug                Enable debug mode
   --no-watch             Disable watching page and config files (default: true)
-  -v, --version          Display version number 
+  -v, --version          Display version number
   -h, --help             Display this message
 ```
 
@@ -67,14 +67,14 @@ Usage:
   $ vuepress build [sourceDir]
 
 Options:
-  -c, --config <config>  Set path to config file 
-  -d, --dest <dest>      Set the directory build output (default: .vuepress/dist) 
-  -t, --temp <temp>      Set the directory of the temporary files 
-  --cache <cache>        Set the directory of the cache files 
-  --clean-temp           Clean the temporary files before build 
-  --clean-cache          Clean the cache files before build 
-  --debug                Enable debug mode 
-  -v, --version          Display version number 
+  -c, --config <config>  Set path to config file
+  -d, --dest <dest>      Set the directory build output (default: .vuepress/dist)
+  -t, --temp <temp>      Set the directory of the temporary files
+  --cache <cache>        Set the directory of the cache files
+  --clean-temp           Clean the temporary files before build
+  --clean-cache          Clean the cache files before build
+  --debug                Enable debug mode
+  -v, --version          Display version number
   -h, --help             Display this message
 ```
 
diff --git a/docs/reference/components.md b/docs/reference/components.md
index 64f5231a..8f5584c9 100644
--- a/docs/reference/components.md
+++ b/docs/reference/components.md
@@ -24,6 +24,7 @@
 ## Content
 
 - Props:
+
   - pageKey
     - Type: `string`
     - Required: `false`
diff --git a/docs/reference/default-theme/components.md b/docs/reference/default-theme/components.md
index 931fb27b..9e1ff8f1 100644
--- a/docs/reference/default-theme/components.md
+++ b/docs/reference/default-theme/components.md
@@ -5,6 +5,7 @@
 ## Badge <Badge text="badge" />
 
 - Props:
+
   - type
     - Type: `'tip' | 'warning' | 'danger'`
     - Default: `'tip'`
@@ -40,6 +41,7 @@
 ## CodeGroupItem
 
 - Props:
+
   - title
     - Type: `string`
     - Required: `true`
diff --git a/docs/reference/default-theme/extending.md b/docs/reference/default-theme/extending.md
index ffa3b5fb..52c1cb02 100644
--- a/docs/reference/default-theme/extending.md
+++ b/docs/reference/default-theme/extending.md
@@ -78,7 +78,10 @@ const __dirname = getDirname(import.meta.url)
 export default defineUserConfig({
   theme: defaultTheme(),
   alias: {
-    '@theme/HomeFooter.vue': path.resolve(__dirname, './components/MyHomeFooter.vue'),
+    '@theme/HomeFooter.vue': path.resolve(
+      __dirname,
+      './components/MyHomeFooter.vue',
+    ),
   },
 })
 ```
@@ -106,7 +109,10 @@ export const childTheme = (options: DefaultThemeOptions): Theme => {
 
     // override component alias
     alias: {
-      '@theme/HomeFooter.vue': path.resolve(__dirname, './components/MyHomeFooter.vue'),
+      '@theme/HomeFooter.vue': path.resolve(
+        __dirname,
+        './components/MyHomeFooter.vue',
+      ),
     },
   }
 }
diff --git a/docs/reference/default-theme/markdown.md b/docs/reference/default-theme/markdown.md
index 81c25905..983bb2c6 100644
--- a/docs/reference/default-theme/markdown.md
+++ b/docs/reference/default-theme/markdown.md
@@ -74,9 +74,11 @@ Danger zone, do not proceed
 :::
 
 ::: details Click me to view the code
+
 ```ts
 console.log('Hello, VuePress!')
 ```
+
 :::
 ````
 
@@ -87,9 +89,11 @@ Danger zone, do not proceed
 :::
 
 ::: details Click me to view the code
+
 ```ts
 console.log('Hello, VuePress!')
 ```
+
 :::
 
 - Example 3 (code group alias):
@@ -99,14 +103,18 @@ console.log('Hello, VuePress!')
 ````md
 :::: code-group
 ::: code-group-item FOO
+
 ```ts
 const foo = 'foo'
 ```
+
 :::
 ::: code-group-item BAR
+
 ```ts
 const bar = 'bar'
 ```
+
 :::
 ::::
 ````
@@ -115,13 +123,17 @@ const bar = 'bar'
 
 :::: code-group
 ::: code-group-item FOO
+
 ```ts
 const foo = 'foo'
 ```
+
 :::
 ::: code-group-item BAR
+
 ```ts
 const bar = 'bar'
 ```
+
 :::
 ::::
diff --git a/docs/reference/frontmatter.md b/docs/reference/frontmatter.md
index 36020eb8..b4bb49dc 100644
--- a/docs/reference/frontmatter.md
+++ b/docs/reference/frontmatter.md
@@ -45,11 +45,11 @@ head:
   - - meta
     - name: foo
       content: yaml array syntax
-  - [meta, { name: bar , content: square brackets syntax }]
+  - [meta, { name: bar, content: square brackets syntax }]
 ---
 ```
 
-  Rendered as:
+Rendered as:
 
 ```html
 <head>
@@ -139,13 +139,13 @@ layout: CustomLayout
 
 - Usage:
 
-  |  Pattern  |         Description         |
-  |-----------|-----------------------------|
-  | `:year`   | Year part of created date   |
-  | `:month`  | Month part of created date  |
-  | `:day`    | Day part of created date    |
-  | `:slug`   | Slug of page filename       |
-  | `:raw`    | Raw route path              |
+  | Pattern  | Description                |
+  | -------- | -------------------------- |
+  | `:year`  | Year part of created date  |
+  | `:month` | Month part of created date |
+  | `:day`   | Day part of created date   |
+  | `:slug`  | Slug of page filename      |
+  | `:raw`   | Raw route path             |
 
   The `:year`, `:month` and `:day` patterns are resolved according to the following priority:
 
@@ -167,7 +167,7 @@ permalinkPattern: :year/:month/:day/:slug.html
 ---
 ```
 
-  Then the permalink of the page would be `2021/01/03/foo-bar.html`.
+Then the permalink of the page would be `2021/01/03/foo-bar.html`.
 
 - Example 2:
 
@@ -181,7 +181,7 @@ permalinkPattern: :year/:month/:day/:slug.html
 ---
 ```
 
-  Then the permalink of the page would be `2021/01/03/bar-baz.html`.
+Then the permalink of the page would be `2021/01/03/bar-baz.html`.
 
 - Also see:
   - [Config > permalinkPattern](./config.md#permalinkpattern)
diff --git a/docs/reference/plugin-api.md b/docs/reference/plugin-api.md
index a8478111..0c83d474 100644
--- a/docs/reference/plugin-api.md
+++ b/docs/reference/plugin-api.md
@@ -115,10 +115,7 @@ import { getDirname, path } from '@vuepress/utils'
 const __dirname = getDirname(import.meta.url)
 
 export default {
-  clientConfigFile: path.resolve(
-    __dirname,
-    './path/to/clientConfig.js',
-  ),
+  clientConfigFile: path.resolve(__dirname, './path/to/clientConfig.js'),
 }
 ```
 
@@ -176,11 +173,13 @@ export default {
       bundlerOptions.vuePluginOptions ??= {}
       bundlerOptions.vuePluginOptions.template ??= {}
       bundlerOptions.vuePluginOptions.template.compilerOptions ??= {}
-      const isCustomElement = bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement
-      bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement = (tag) => {
-        if (isCustomElement?.(tag)) return true
-        if (tag === 'my-custom-element') return true
-      }
+      const isCustomElement =
+        bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement
+      bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement =
+        (tag) => {
+          if (isCustomElement?.(tag)) return true
+          if (tag === 'my-custom-element') return true
+        }
     }
 
     // extends options of @vuepress/bundler-webpack
diff --git a/docs/reference/plugin/back-to-top.md b/docs/reference/plugin/back-to-top.md
index edb77284..6e959648 100644
--- a/docs/reference/plugin/back-to-top.md
+++ b/docs/reference/plugin/back-to-top.md
@@ -16,9 +16,7 @@ npm i -D @vuepress/plugin-back-to-top@next
 import { backToTopPlugin } from '@vuepress/plugin-back-to-top'
 
 export default {
-  plugins: [
-    backToTopPlugin(),
-  ],
+  plugins: [backToTopPlugin()],
 }
 ```
 
diff --git a/docs/reference/plugin/container.md b/docs/reference/plugin/container.md
index e5362529..e5d2eb81 100644
--- a/docs/reference/plugin/container.md
+++ b/docs/reference/plugin/container.md
@@ -94,7 +94,7 @@ export default {
 - Default:
 
 ```ts
-(info: string): string =>
+;(info: string): string =>
   `<div class="custom-container ${type}">${
     info ? `<p class="custom-container-title">${info}</p>` : ''
   }\n`
@@ -115,7 +115,7 @@ export default {
 - Default:
 
 ```ts
-(): string => '</div>\n'
+;(): string => '</div>\n'
 ```
 
 - Details:
diff --git a/docs/reference/plugin/docsearch.md b/docs/reference/plugin/docsearch.md
index 39762436..0b437553 100644
--- a/docs/reference/plugin/docsearch.md
+++ b/docs/reference/plugin/docsearch.md
@@ -328,7 +328,7 @@ export default {
   The base path of the search index.
 
   If you are deploying your site to multiple domains, you don't need to submit all of them to DocSearch and generate search index separately. You could choose one of the domains as the _index domain_, and only submit the _index domain_ to Docsearch for crawling search index. Then, you could reuse the search index across all deployments.
-  
+
   However, if the [base](../config.md#base) of your deployments are different for different domains, you need to set the option to the [base](../config.md#base) of your _index domain_, so that other deployments could reuse the search index correctly.
 
 ### injectStyles
diff --git a/docs/reference/plugin/medium-zoom.md b/docs/reference/plugin/medium-zoom.md
index 1edce76d..362dce25 100644
--- a/docs/reference/plugin/medium-zoom.md
+++ b/docs/reference/plugin/medium-zoom.md
@@ -90,7 +90,7 @@ export default {
     const zoom = useMediumZoom()
 
     // ... do something to add new images in current page
-  
+
     // then you may need to call `refresh` manually to make those new images zoomable
     nextTick(() => {
       zoom.refresh()
diff --git a/docs/reference/plugin/nprogress.md b/docs/reference/plugin/nprogress.md
index 6671502f..2f501345 100644
--- a/docs/reference/plugin/nprogress.md
+++ b/docs/reference/plugin/nprogress.md
@@ -24,9 +24,7 @@ npm i -D @vuepress/plugin-nprogress@next
 import { nprogressPlugin } from '@vuepress/plugin-nprogress'
 
 export default {
-  plugins: [
-    nprogressPlugin(),
-  ],
+  plugins: [nprogressPlugin()],
 }
 ```
 
diff --git a/docs/reference/plugin/palette.md b/docs/reference/plugin/palette.md
index 5bb01d10..a5a5ecb8 100644
--- a/docs/reference/plugin/palette.md
+++ b/docs/reference/plugin/palette.md
@@ -41,9 +41,7 @@ Use this plugin in your theme, assuming you are using SASS:
 ```ts
 export default {
   // ...
-  plugins: [
-    palettePlugin({ preset: 'sass' }),
-  ],
+  plugins: [palettePlugin({ preset: 'sass' })],
 }
 ```
 
@@ -114,6 +112,7 @@ h1 {
 - Type: `string`
 
 - Default:
+
   - css: `'.vuepress/styles/palette.css'`
   - sass: `'.vuepress/styles/palette.scss'`
   - less: `'.vuepress/styles/palette.less'`
@@ -132,6 +131,7 @@ h1 {
 - Type: `string`
 
 - Default:
+
   - css: `'styles/palette.css'`
   - sass: `'styles/palette.scss'`
   - less: `'styles/palette.less'`
@@ -150,6 +150,7 @@ h1 {
 - Type: `string`
 
 - Default:
+
   - css: `'.vuepress/styles/index.css'`
   - sass: `'.vuepress/styles/index.scss'`
   - less: `'.vuepress/styles/index.less'`
@@ -168,6 +169,7 @@ h1 {
 - Type: `string`
 
 - Default:
+
   - css: `'styles/index.css'`
   - sass: `'styles/index.scss'`
   - less: `'styles/index.less'`
@@ -186,6 +188,7 @@ h1 {
 - Type: `(filePath: string) => string`
 
 - Default:
+
   - css: `` (filePath) => `@import '${filePath}';\n` ``
   - sass: `` (filePath) => `@forward 'file:///${filePath}';\n` ``
   - less: `` (filePath) => `@import '${filePath}';\n` ``
diff --git a/docs/reference/plugin/pwa.md b/docs/reference/plugin/pwa.md
index c999be18..e94f7697 100644
--- a/docs/reference/plugin/pwa.md
+++ b/docs/reference/plugin/pwa.md
@@ -147,7 +147,7 @@ export default {
 
 - Parameters:
 
-|  Parameter   | Type                        | Description                                              |
+| Parameter    | Type                        | Description                                              |
 | ------------ | --------------------------- | -------------------------------------------------------- |
 | registration | `ServiceWorkerRegistration` | The registration of the service worker you want activate |
 
diff --git a/docs/reference/plugin/theme-data.md b/docs/reference/plugin/theme-data.md
index 211216af..ecf2ea5a 100644
--- a/docs/reference/plugin/theme-data.md
+++ b/docs/reference/plugin/theme-data.md
@@ -70,7 +70,7 @@ The theme data object will be processed by `JSON.stringify()` before forwarding
 - Details:
 
   Returns the theme data ref object.
-  
+
   The value is provided by [themeData](#themeData) option.
 
 - Example:
diff --git a/docs/reference/plugin/toc.md b/docs/reference/plugin/toc.md
index 21f65f2a..f298dee1 100644
--- a/docs/reference/plugin/toc.md
+++ b/docs/reference/plugin/toc.md
@@ -28,6 +28,7 @@ Similar to the [Table of Contents Markdown Syntax](../../guide/markdown.md#table
 
 ```md
 <!-- markdown toc syntax -->
+
 [[toc]]
 
 <!-- vue toc component -->
@@ -159,7 +160,9 @@ const defaultOptions = {
           <!-- item -->
           <li class="vuepress-toc-item">
             <!-- link (active) -->
-            <RouterLink class="vuepress-toc-link active" to="#bar-child">Bar Child</RouterLink>
+            <RouterLink class="vuepress-toc-link active" to="#bar-child"
+              >Bar Child</RouterLink
+            >
           </li>
         </ul>
       </li>
diff --git a/docs/zh/advanced/cookbook/passing-data-to-client-code.md b/docs/zh/advanced/cookbook/passing-data-to-client-code.md
index 3e2fa98a..d22dfa47 100644
--- a/docs/zh/advanced/cookbook/passing-data-to-client-code.md
+++ b/docs/zh/advanced/cookbook/passing-data-to-client-code.md
@@ -43,7 +43,10 @@ declare const __OBJ__: { bar: number }
 export default (options) => ({
   async onPrepared(app) {
     // 写入临时文件
-    await app.writeTemp('foo.js', `export const foo = ${JSON.stringify(options.foo)}`)
+    await app.writeTemp(
+      'foo.js',
+      `export const foo = ${JSON.stringify(options.foo)}`,
+    )
   },
 })
 ```
diff --git a/docs/zh/advanced/plugin.md b/docs/zh/advanced/plugin.md
index 5cae7723..8f53a186 100644
--- a/docs/zh/advanced/plugin.md
+++ b/docs/zh/advanced/plugin.md
@@ -6,7 +6,7 @@
 
 ## 创建一个插件
 
-插件是一个符合 [插件 API](../reference/plugin-api.md) 的普通 JavaScript 对象，称之为 *插件对象* ：
+插件是一个符合 [插件 API](../reference/plugin-api.md) 的普通 JavaScript 对象，称之为 _插件对象_ ：
 
 ```ts
 const fooPlugin = {
@@ -15,7 +15,7 @@ const fooPlugin = {
 }
 ```
 
-插件还可以是一个接收 [App 实例](../reference/node-api.md#app) 作为参数，且返回值为 *插件对象* 的函数，称之为 *插件函数* ：
+插件还可以是一个接收 [App 实例](../reference/node-api.md#app) 作为参数，且返回值为 _插件对象_ 的函数，称之为 _插件函数_ ：
 
 ```ts
 const barPlugin = (app) => {
@@ -26,7 +26,7 @@ const barPlugin = (app) => {
 }
 ```
 
-插件通常需要允许用户传入配置，因此我们一般都会提供给用户一个函数来接收配置，然后将 *插件对象* 或者 *插件函数* 作为返回值。于是，你的插件应该转换成这样的形式：
+插件通常需要允许用户传入配置，因此我们一般都会提供给用户一个函数来接收配置，然后将 _插件对象_ 或者 _插件函数_ 作为返回值。于是，你的插件应该转换成这样的形式：
 
 ```ts
 const fooPlugin = (options) => {
@@ -53,11 +53,9 @@ const barPlugin = (options) => {
 ```json
 {
   "name": "vuepress-plugin-foo",
-  "keywords": [
-    "vuepress-plugin"
-  ]
+  "keywords": ["vuepress-plugin"]
 }
 ```
 
-- 将 `name` 按照约定命名，即 `vuepress-plugin-xxx` 或 `@org/vuepress-plugin-xxx` ，它应该和 *插件对象* 的 [name](../reference/plugin-api.md#name) 字段保持一致。
+- 将 `name` 按照约定命名，即 `vuepress-plugin-xxx` 或 `@org/vuepress-plugin-xxx` ，它应该和 _插件对象_ 的 [name](../reference/plugin-api.md#name) 字段保持一致。
 - 在 `keywords` 中包含 `vuepress-plugin` ，这样用户可以在 NPM 上搜索到你的插件。
diff --git a/docs/zh/advanced/theme.md b/docs/zh/advanced/theme.md
index deba1404..08e33ba5 100644
--- a/docs/zh/advanced/theme.md
+++ b/docs/zh/advanced/theme.md
@@ -6,7 +6,7 @@
 
 ## 创建一个主题
 
-VuePress 主题是一个特殊的插件，它应该符合 [主题 API](../reference/theme-api.md) 。和插件一样，主题可以是一个 *主题对象* 或一个 *主题函数* ，并且通常通过一个函数来接收配置项：
+VuePress 主题是一个特殊的插件，它应该符合 [主题 API](../reference/theme-api.md) 。和插件一样，主题可以是一个 _主题对象_ 或一个 _主题函数_ ，并且通常通过一个函数来接收配置项：
 
 ```ts
 import { getDirname, path } from '@vuepress/utils'
@@ -90,11 +90,9 @@ export default defineClientConfig({
 ```json
 {
   "name": "vuepress-theme-foo",
-  "keywords": [
-    "vuepress-theme"
-  ]
+  "keywords": ["vuepress-theme"]
 }
 ```
 
-- 将 `name` 按照约定命名： `vuepress-theme-xxx` 或 `@org/vuepress-theme-xxx` ，它应该和 *主题对象* 的 [name](../reference/theme-api.md#name) 字段保持一致。
+- 将 `name` 按照约定命名： `vuepress-theme-xxx` 或 `@org/vuepress-theme-xxx` ，它应该和 _主题对象_ 的 [name](../reference/theme-api.md#name) 字段保持一致。
 - 在 `keywords` 中包含 `vuepress-theme` ，这样用户可以在 NPM 上搜索到你的主题。
diff --git a/docs/zh/guide/assets.md b/docs/zh/guide/assets.md
index 80df50b7..0fe58afd 100644
--- a/docs/zh/guide/assets.md
+++ b/docs/zh/guide/assets.md
@@ -60,6 +60,7 @@
 
 ```md
 <!-- 你不需要给 `/images/hero.png` 手动添加 `/bar/` 前缀 -->
+
 ![VuePress Logo](/images/hero.png)
 ```
 
@@ -67,7 +68,7 @@
 
 ```vue
 <template>
-  <img :src="withBase(logoPath)">
+  <img :src="withBase(logoPath)" />
 </template>
 
 <script setup>
diff --git a/docs/zh/guide/deployment.md b/docs/zh/guide/deployment.md
index 4923ac76..b5922d5f 100644
--- a/docs/zh/guide/deployment.md
+++ b/docs/zh/guide/deployment.md
@@ -28,6 +28,7 @@
    创建 `.github/workflows/docs.yml` 文件来配置工作流。
 
 ::: details 点击展开配置样例
+
 ```yaml
 name: docs
 
@@ -81,6 +82,7 @@ jobs:
           # @see https://docs.github.com/cn/actions/reference/authentication-in-a-workflow#about-the-github_token-secret
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
+
 :::
 
 ::: tip
@@ -98,6 +100,7 @@ jobs:
 2. 创建 `.gitlab-ci.yml` 文件来配置 [GitLab CI](https://about.gitlab.com/stages-devops-lifecycle/continuous-integration/) 工作流。
 
 ::: details 点击展开配置样例
+
 ```yaml
 # 选择你要使用的 docker 镜像
 image: node:18-buster
@@ -129,6 +132,7 @@ pages:
     paths:
       - public
 ```
+
 :::
 
 ::: tip
diff --git a/docs/zh/guide/markdown.md b/docs/zh/guide/markdown.md
index 930c5e72..b1e440f3 100644
--- a/docs/zh/guide/markdown.md
+++ b/docs/zh/guide/markdown.md
@@ -49,14 +49,19 @@ VuePress 会使用 [markdown-it](https://github.com/markdown-it/markdown-it) 来
 
 ```md
 <!-- 相对路径 -->
+
 [首页](../README.md)  
 [配置参考](../reference/config.md)  
-[快速上手](./getting-started.md)  
+[快速上手](./getting-started.md)
+
 <!-- 绝对路径 -->
+
 [指南](/zh/guide/README.md)  
-[配置参考 > markdown.links](/zh/reference/config.md#links)  
+[配置参考 > markdown.links](/zh/reference/config.md#links)
+
 <!-- URL -->
-[GitHub](https://github.com) 
+
+[GitHub](https://github.com)
 ```
 
 **转换为**
@@ -67,8 +72,12 @@ VuePress 会使用 [markdown-it](https://github.com/markdown-it/markdown-it) 来
   <RouterLink to="/zh/reference/config.html">配置参考</RouterLink>
   <RouterLink to="/zh/guide/getting-started.html">快速上手</RouterLink>
   <RouterLink to="/zh/guide/">指南</RouterLink>
-  <RouterLink to="/zh/reference/config.html#links">配置参考 &gt; markdown.links</RouterLink>
-  <a href="https://github.com" target="_blank" rel="noopener noreferrer">GitHub</a>
+  <RouterLink to="/zh/reference/config.html#links"
+    >配置参考 &gt; markdown.links</RouterLink
+  >
+  <a href="https://github.com" target="_blank" rel="noopener noreferrer"
+    >GitHub</a
+  >
 </template>
 ```
 
@@ -79,7 +88,7 @@ VuePress 会使用 [markdown-it](https://github.com/markdown-it/markdown-it) 来
 [快速上手](./getting-started.md)  
 [指南](/zh/guide/README.md)  
 [配置参考 > markdown.links](/zh/reference/config.md#links)  
-[GitHub](https://github.com) 
+[GitHub](https://github.com)
 
 **解释**
 
@@ -141,7 +150,6 @@ Emoji 扩展由 [markdown-it-emoji](https://github.com/markdown-it/markdown-it-e
 ::: tip
 目录扩展由 [@mdit-vue/plugin-toc](https://github.com/mdit-vue/mdit-vue/tree/main/packages/plugin-toc) 支持。
 
-
 配置参考： [markdown.toc](../reference/config.md#markdown-toc)
 :::
 
@@ -190,7 +198,7 @@ export default defineUserConfig({
 - 组合： `{4,7-13,16,23-27,40}`
 
 ::: tip
-行高亮扩展是由我们的内置插件支持的，该扩展 Fork 并修改自  [markdown-it-highlight-lines](https://github.com/egoist/markdown-it-highlight-lines)。
+行高亮扩展是由我们的内置插件支持的，该扩展 Fork 并修改自 [markdown-it-highlight-lines](https://github.com/egoist/markdown-it-highlight-lines)。
 
 配置参考： [markdown.code.highlightLines](../reference/config.md#markdown-code-highlightlines)
 :::
@@ -256,6 +264,7 @@ const line3 = 'This is line 3'
 ````md
 ```md
 <!-- 默认情况下，这里会被保持原样 -->
+
 1 + 2 + 3 = {{ 1 + 2 + 3 }}
 ```
 
@@ -274,6 +283,7 @@ const onePlusTwoPlusThree = {{ 1 + 2 + 3 }}
 
 ```md
 <!-- 默认情况下，这里会被保持原样 -->
+
 1 + 2 + 3 = {{ 1 + 2 + 3 }}
 ```
 
@@ -304,6 +314,7 @@ v-pre 扩展是由我们的内置插件支持的。
 
 ```md
 <!-- 最简单的语法 -->
+
 @[code](../foo.js)
 ```
 
@@ -311,6 +322,7 @@ v-pre 扩展是由我们的内置插件支持的。
 
 ```md
 <!-- 仅导入第 1 行至第 10 行 -->
+
 @[code{1-10}](../foo.js)
 ```
 
@@ -318,6 +330,7 @@ v-pre 扩展是由我们的内置插件支持的。
 
 ```md
 <!-- 指定代码语言 -->
+
 @[code js](../foo.js)
 ```
 
@@ -325,6 +338,7 @@ v-pre 扩展是由我们的内置插件支持的。
 
 ```md
 <!-- 行高亮 -->
+
 @[code js{2,4-5}](../foo.js)
 ```
 
@@ -358,6 +372,7 @@ export default {
 
 ```md
 <!-- 会被解析至 'path/to/src/foo.js' -->
+
 @[code](@src/foo.js)
 ```
 
diff --git a/docs/zh/guide/page.md b/docs/zh/guide/page.md
index 195aa649..0d166ce7 100644
--- a/docs/zh/guide/page.md
+++ b/docs/zh/guide/page.md
@@ -19,8 +19,8 @@ VuePress 是以 Markdown 为中心的。你项目中的每一个 Markdown 文件
 
 将 `docs` 目录作为你的 [sourceDir](../reference/cli.md) ，例如你在运行 `vuepress dev docs` 命令。此时，你的 Markdown 文件对应的路由路径为：
 
-| 相对路径                     | 路由路径                       |
-|-----------------------------|-------------------------------|
+| 相对路径                    | 路由路径                      |
+| --------------------------- | ----------------------------- |
 | `/README.md`                | `/`                           |
 | `/index.md`                 | `/`                           |
 | `/contributing.md`          | `/contributing.html`          |
diff --git a/docs/zh/guide/plugin.md b/docs/zh/guide/plugin.md
index 9201051c..46f04328 100644
--- a/docs/zh/guide/plugin.md
+++ b/docs/zh/guide/plugin.md
@@ -38,9 +38,7 @@ export default {
 import myPlugin from './path/to/my-plugin.js'
 
 export default {
-  plugins: [
-    myPlugin(),
-  ],
+  plugins: [myPlugin()],
 }
 ```
 
diff --git a/docs/zh/reference/cli.md b/docs/zh/reference/cli.md
index 5e162cae..c0a8ba6b 100644
--- a/docs/zh/reference/cli.md
+++ b/docs/zh/reference/cli.md
@@ -21,8 +21,8 @@ For more info, run any command with the `--help` flag:
   $ vuepress info --help
 
 Options:
-  -v, --version  Display version number 
-  -h, --help     Display this message 
+  -v, --version  Display version number
+  -h, --help     Display this message
 ```
 
 ::: tip
@@ -40,17 +40,17 @@ Usage:
   $ vuepress dev [sourceDir]
 
 Options:
-  -c, --config <config>  Set path to config file 
-  -p, --port <port>      Use specified port (default: 8080) 
-  -t, --temp <temp>      Set the directory of the temporary files 
-  --host <host>          Use specified host (default: 0.0.0.0) 
-  --cache <cache>        Set the directory of the cache files 
-  --clean-temp           Clean the temporary files before dev 
-  --clean-cache          Clean the cache files before dev 
-  --open                 Open browser when ready 
-  --debug                Enable debug mode 
+  -c, --config <config>  Set path to config file
+  -p, --port <port>      Use specified port (default: 8080)
+  -t, --temp <temp>      Set the directory of the temporary files
+  --host <host>          Use specified host (default: 0.0.0.0)
+  --cache <cache>        Set the directory of the cache files
+  --clean-temp           Clean the temporary files before dev
+  --clean-cache          Clean the cache files before dev
+  --open                 Open browser when ready
+  --debug                Enable debug mode
   --no-watch             Disable watching page and config files (default: true)
-  -v, --version          Display version number 
+  -v, --version          Display version number
   -h, --help             Display this message
 ```
 
@@ -67,14 +67,14 @@ Usage:
   $ vuepress build [sourceDir]
 
 Options:
-  -c, --config <config>  Set path to config file 
-  -d, --dest <dest>      Set the directory build output (default: .vuepress/dist) 
-  -t, --temp <temp>      Set the directory of the temporary files 
-  --cache <cache>        Set the directory of the cache files 
-  --clean-temp           Clean the temporary files before build 
-  --clean-cache          Clean the cache files before build 
-  --debug                Enable debug mode 
-  -v, --version          Display version number 
+  -c, --config <config>  Set path to config file
+  -d, --dest <dest>      Set the directory build output (default: .vuepress/dist)
+  -t, --temp <temp>      Set the directory of the temporary files
+  --cache <cache>        Set the directory of the cache files
+  --clean-temp           Clean the temporary files before build
+  --clean-cache          Clean the cache files before build
+  --debug                Enable debug mode
+  -v, --version          Display version number
   -h, --help             Display this message
 ```
 
diff --git a/docs/zh/reference/components.md b/docs/zh/reference/components.md
index 047b375d..a6218468 100644
--- a/docs/zh/reference/components.md
+++ b/docs/zh/reference/components.md
@@ -24,6 +24,7 @@
 ## Content
 
 - Props:
+
   - pageKey
     - 类型： `string`
     - 是否必须： `false`
diff --git a/docs/zh/reference/default-theme/components.md b/docs/zh/reference/default-theme/components.md
index cad204ba..d827ec11 100644
--- a/docs/zh/reference/default-theme/components.md
+++ b/docs/zh/reference/default-theme/components.md
@@ -5,6 +5,7 @@
 ## Badge <Badge text="badge" />
 
 - Props:
+
   - type
     - 类型： `'tip' | 'warning' | 'danger'`
     - 默认值： `'tip'`
@@ -40,6 +41,7 @@
 ## CodeGroupItem
 
 - Props:
+
   - title
     - 类型： `string`
     - 是否必需： `true`
diff --git a/docs/zh/reference/default-theme/extending.md b/docs/zh/reference/default-theme/extending.md
index e961a266..0b57b86e 100644
--- a/docs/zh/reference/default-theme/extending.md
+++ b/docs/zh/reference/default-theme/extending.md
@@ -78,7 +78,10 @@ const __dirname = getDirname(import.meta.url)
 export default defineUserConfig({
   theme: defaultTheme(),
   alias: {
-    '@theme/HomeFooter.vue': path.resolve(__dirname, './components/MyHomeFooter.vue'),
+    '@theme/HomeFooter.vue': path.resolve(
+      __dirname,
+      './components/MyHomeFooter.vue',
+    ),
   },
 })
 ```
@@ -105,7 +108,10 @@ export const childTheme = (options: DefaultThemeOptions): Theme => {
 
     // 覆盖组件别名
     alias: {
-      '@theme/HomeFooter.vue': path.resolve(__dirname, './components/MyHomeFooter.vue'),
+      '@theme/HomeFooter.vue': path.resolve(
+        __dirname,
+        './components/MyHomeFooter.vue',
+      ),
     },
   }
 }
diff --git a/docs/zh/reference/default-theme/markdown.md b/docs/zh/reference/default-theme/markdown.md
index 4e079d26..fc5f10c2 100644
--- a/docs/zh/reference/default-theme/markdown.md
+++ b/docs/zh/reference/default-theme/markdown.md
@@ -74,9 +74,11 @@
 :::
 
 ::: details 点击查看代码
+
 ```ts
 console.log('你好，VuePress！')
 ```
+
 :::
 ````
 
@@ -87,9 +89,11 @@ console.log('你好，VuePress！')
 :::
 
 ::: details 点击查看代码
+
 ```ts
 console.log('你好，VuePress！')
 ```
+
 :::
 
 - 示例 3 （Code Group 别名）：
@@ -99,14 +103,18 @@ console.log('你好，VuePress！')
 ````md
 :::: code-group
 ::: code-group-item FOO
+
 ```ts
 const foo = 'foo'
 ```
+
 :::
 ::: code-group-item BAR
+
 ```ts
 const bar = 'bar'
 ```
+
 :::
 ::::
 ````
@@ -115,13 +123,17 @@ const bar = 'bar'
 
 :::: code-group
 ::: code-group-item FOO
+
 ```ts
 const foo = 'foo'
 ```
+
 :::
 ::: code-group-item BAR
+
 ```ts
 const bar = 'bar'
 ```
+
 :::
 ::::
diff --git a/docs/zh/reference/frontmatter.md b/docs/zh/reference/frontmatter.md
index a79fbc4f..087c00df 100644
--- a/docs/zh/reference/frontmatter.md
+++ b/docs/zh/reference/frontmatter.md
@@ -45,11 +45,11 @@ head:
   - - meta
     - name: foo
       content: yaml 数组语法
-  - [meta, { name: bar , content: 方括号语法 }]
+  - [meta, { name: bar, content: 方括号语法 }]
 ---
 ```
 
-  渲染为：
+渲染为：
 
 ```html
 <head>
@@ -139,13 +139,13 @@ layout: CustomLayout
 
 - 使用：
 
-  |  Pattern  |       描述        |
-  |-----------|-------------------|
-  | `:year`   | 创建日期的 年 部分 |
-  | `:month`  | 创建日期的 月 部分 |
-  | `:day`    | 创建日期的 日 部分 |
-  | `:slug`   | 页面文件名的 Slug  |
-  | `:raw`    | 原始路由路径       |
+  | Pattern  | 描述               |
+  | -------- | ------------------ |
+  | `:year`  | 创建日期的 年 部分 |
+  | `:month` | 创建日期的 月 部分 |
+  | `:day`   | 创建日期的 日 部分 |
+  | `:slug`  | 页面文件名的 Slug  |
+  | `:raw`   | 原始路由路径       |
 
   `:year`, `:month` 和 `:day` Pattern 根据如下优先级进行解析：
 
@@ -167,7 +167,7 @@ permalinkPattern: :year/:month/:day/:slug.html
 ---
 ```
 
-  那么页面的永久链接将会是 `2021/01/03/foo-bar.html` 。
+那么页面的永久链接将会是 `2021/01/03/foo-bar.html` 。
 
 - 示例 2 ：
 
@@ -181,7 +181,7 @@ permalinkPattern: :year/:month/:day/:slug.html
 ---
 ```
 
-  那么页面的永久链接将会是 `2021/01/03/bar-baz.html` 。
+那么页面的永久链接将会是 `2021/01/03/bar-baz.html` 。
 
 - 参考：
   - [配置 > permalinkPattern](./config.md#permalinkpattern)
diff --git a/docs/zh/reference/node-api.md b/docs/zh/reference/node-api.md
index 2f5a1040..5344c35c 100644
--- a/docs/zh/reference/node-api.md
+++ b/docs/zh/reference/node-api.md
@@ -24,9 +24,9 @@ const createBuildApp: (config: AppConfig) => BuildApp
 
 - 参数：
 
-| 参数      | 类型         | 描述                      |
-|-----------|-------------|---------------------------|
-| config    | `AppConfig` | 创建 VuePress App 的选项。 |
+| 参数   | 类型        | 描述                       |
+| ------ | ----------- | -------------------------- |
+| config | `AppConfig` | 创建 VuePress App 的选项。 |
 
 - 详情：
 
@@ -65,9 +65,9 @@ const createDevApp: (config: AppConfig) => DevApp
 
 - 参数：
 
-| 参数      | 类型         | 描述                      |
-|-----------|-------------|---------------------------|
-| config    | `AppConfig` | 创建 VuePress App 的选项。 |
+| 参数   | 类型        | 描述                       |
+| ------ | ----------- | -------------------------- |
+| config | `AppConfig` | 创建 VuePress App 的选项。 |
 
 - 详情：
 
@@ -187,6 +187,7 @@ const dev = async () => {
 ### dir
 
 - 工具函数：
+
   - `dir.cache()`： 解析至缓存目录
   - `dir.temp()`： 解析至临时文件目录
   - `dir.source()`： 解析至源文件目录
@@ -223,10 +224,10 @@ writeTemp(file: string, content: string): Promise<string>
 
 - 参数：
 
-| 参数      | 类型      | 描述                                      |
-|-----------|----------|-------------------------------------------|
-| file      | `string` | 要写入的临时文件的路径，相对于临时文件目录。 |
-| content   | `string` | 要写入的临时文件路径的内容。                |
+| 参数    | 类型     | 描述                                         |
+| ------- | -------- | -------------------------------------------- |
+| file    | `string` | 要写入的临时文件的路径，相对于临时文件目录。 |
+| content | `string` | 要写入的临时文件路径的内容。                 |
 
 - 详情：
 
@@ -326,10 +327,10 @@ const createPage: (app: App, options: PageOptions) => Promise<Page>
 
 - 参数：
 
-| 参数      | 类型          | 描述                        |
-|-----------|---------------|----------------------------|
-| app       | `App`         | VuePress App 实例。        |
-| options   | `PageOptions` | 创建 VuePress Page 的选项。 |
+| 参数    | 类型          | 描述                        |
+| ------- | ------------- | --------------------------- |
+| app     | `App`         | VuePress App 实例。         |
+| options | `PageOptions` | 创建 VuePress Page 的选项。 |
 
 - 详情：
 
@@ -411,6 +412,7 @@ export default {
   该 Page 的语言。
 
 - 示例：
+
   - `'en-US'`
   - `'zh-CN'`
 
@@ -498,6 +500,7 @@ interface PageData {
   该 Page 的日期，遵从 'yyyy-MM-dd' 格式。
 
 - 示例：
+
   - `'0000-00-00'`
   - `'2021-08-16`'
 
@@ -561,6 +564,7 @@ interface MarkdownLink {
   如果该 Page 不是来自于 Markdown 源文件，那么该属性会为 `null` 。
 
 - 示例：
+
   - `'/'`
   - `'/foo.html'`
 
@@ -579,6 +583,7 @@ interface MarkdownLink {
   它是根据页面的 Markdown 源文件相对路径、以及用户配置的 `locales` 的键推断得到的。
 
 - 示例：
+
   - `'/'`
   - `'/en/'`
   - `'/zh/'`
diff --git a/docs/zh/reference/plugin-api.md b/docs/zh/reference/plugin-api.md
index a3ee48c0..5b8085e7 100644
--- a/docs/zh/reference/plugin-api.md
+++ b/docs/zh/reference/plugin-api.md
@@ -173,11 +173,13 @@ export default {
       bundlerOptions.vuePluginOptions ??= {}
       bundlerOptions.vuePluginOptions.template ??= {}
       bundlerOptions.vuePluginOptions.template.compilerOptions ??= {}
-      const isCustomElement = bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement
-      bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement = (tag) => {
-        if (isCustomElement?.(tag)) return true
-        if (tag === 'my-custom-element') return true
-      }
+      const isCustomElement =
+        bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement
+      bundlerOptions.vuePluginOptions.template.compilerOptions.isCustomElement =
+        (tag) => {
+          if (isCustomElement?.(tag)) return true
+          if (tag === 'my-custom-element') return true
+        }
     }
 
     // 修改 @vuepress/bundler-webpack 的配置项
diff --git a/docs/zh/reference/plugin/back-to-top.md b/docs/zh/reference/plugin/back-to-top.md
index 5c661478..79de8e14 100644
--- a/docs/zh/reference/plugin/back-to-top.md
+++ b/docs/zh/reference/plugin/back-to-top.md
@@ -16,9 +16,7 @@ npm i -D @vuepress/plugin-back-to-top@next
 import { backToTopPlugin } from '@vuepress/plugin-back-to-top'
 
 export default {
-  plugins: [
-    backToTopPlugin(),
-  ],
+  plugins: [backToTopPlugin()],
 }
 ```
 
diff --git a/docs/zh/reference/plugin/container.md b/docs/zh/reference/plugin/container.md
index 730fe078..b042a390 100644
--- a/docs/zh/reference/plugin/container.md
+++ b/docs/zh/reference/plugin/container.md
@@ -94,7 +94,7 @@ export default {
 - 默认值：
 
 ```ts
-(info: string): string =>
+;(info: string): string =>
   `<div class="custom-container ${type}">${
     info ? `<p class="custom-container-title">${info}</p>` : ''
   }\n`
@@ -115,7 +115,7 @@ export default {
 - 默认值：
 
 ```ts
-(): string => '</div>\n'
+;(): string => '</div>\n'
 ```
 
 - 详情：
diff --git a/docs/zh/reference/plugin/nprogress.md b/docs/zh/reference/plugin/nprogress.md
index 01e25a30..2e1a600b 100644
--- a/docs/zh/reference/plugin/nprogress.md
+++ b/docs/zh/reference/plugin/nprogress.md
@@ -24,9 +24,7 @@ npm i -D @vuepress/plugin-nprogress@next
 import { nprogressPlugin } from '@vuepress/plugin-nprogress'
 
 export default {
-  plugins: [
-    nprogressPlugin(),
-  ],
+  plugins: [nprogressPlugin()],
 }
 ```
 
diff --git a/docs/zh/reference/plugin/palette.md b/docs/zh/reference/plugin/palette.md
index a6e53e0a..3499c994 100644
--- a/docs/zh/reference/plugin/palette.md
+++ b/docs/zh/reference/plugin/palette.md
@@ -41,9 +41,7 @@ export default {
 ```ts
 export default {
   // ...
-  plugins: [
-    palettePlugin({ preset: 'sass' }),
-  ],
+  plugins: [palettePlugin({ preset: 'sass' })],
 }
 ```
 
@@ -114,6 +112,7 @@ h1 {
 - 类型： `string`
 
 - 默认值：
+
   - css: `'.vuepress/styles/palette.css'`
   - sass: `'.vuepress/styles/palette.scss'`
   - less: `'.vuepress/styles/palette.less'`
@@ -132,6 +131,7 @@ h1 {
 - 类型： `string`
 
 - 默认值：
+
   - css: `'styles/palette.css'`
   - sass: `'styles/palette.scss'`
   - less: `'styles/palette.less'`
@@ -150,6 +150,7 @@ h1 {
 - 类型： `string`
 
 - 默认值：
+
   - css: `'.vuepress/styles/index.css'`
   - sass: `'.vuepress/styles/index.scss'`
   - less: `'.vuepress/styles/index.less'`
@@ -168,6 +169,7 @@ h1 {
 - 类型： `string`
 
 - 默认值：
+
   - css: `'styles/index.css'`
   - sass: `'styles/index.scss'`
   - less: `'styles/index.less'`
@@ -186,6 +188,7 @@ h1 {
 - 类型： `(filePath: string) => string`
 
 - 默认值：
+
   - css: `` (filePath) => `@import '${filePath}';\n` ``
   - sass: `` (filePath) => `@forward 'file:///${filePath}';\n` ``
   - less: `` (filePath) => `@import '${filePath}';\n` ``
diff --git a/docs/zh/reference/plugin/pwa.md b/docs/zh/reference/plugin/pwa.md
index 020495a6..50d6733f 100644
--- a/docs/zh/reference/plugin/pwa.md
+++ b/docs/zh/reference/plugin/pwa.md
@@ -147,9 +147,9 @@ export default {
 
 - 参数：
 
-|  参数         | 类型                        | 描述                                       |
-| ------------ | --------------------------- | ----------------------------------------- |
-| registration | `ServiceWorkerRegistration` | 你想要激活的 Service Worker 的 Registration  |
+| 参数         | 类型                        | 描述                                        |
+| ------------ | --------------------------- | ------------------------------------------- |
+| registration | `ServiceWorkerRegistration` | 你想要激活的 Service Worker 的 Registration |
 
 - 详情：
 
diff --git a/docs/zh/reference/plugin/theme-data.md b/docs/zh/reference/plugin/theme-data.md
index bf4e2a25..ed4a3ca6 100644
--- a/docs/zh/reference/plugin/theme-data.md
+++ b/docs/zh/reference/plugin/theme-data.md
@@ -70,7 +70,7 @@ export default {
 - 详情：
 
   返回主题数据的 Ref 对象。
-  
+
   数据是通过 [themeData](#themeData) 配置项提供的。
 
 - 示例：
diff --git a/docs/zh/reference/plugin/toc.md b/docs/zh/reference/plugin/toc.md
index f6ede78d..c20a2dc0 100644
--- a/docs/zh/reference/plugin/toc.md
+++ b/docs/zh/reference/plugin/toc.md
@@ -28,6 +28,7 @@ export default {
 
 ```md
 <!-- Markdown 目录语法 -->
+
 [[toc]]
 
 <!-- Vue 目录组件 -->
@@ -159,7 +160,9 @@ const defaultOptions = {
           <!-- item -->
           <li class="vuepress-toc-item">
             <!-- link (active) -->
-            <RouterLink class="vuepress-toc-link active" to="#bar-child">Bar Child</RouterLink>
+            <RouterLink class="vuepress-toc-link active" to="#bar-child"
+              >Bar Child</RouterLink
+            >
           </li>
         </ul>
       </li>
diff --git a/package.json b/package.json
index de24e19c..b58501f7 100644
--- a/package.json
+++ b/package.json
@@ -9,6 +9,7 @@
     "docs:clean": "rimraf docs/.vuepress/.temp docs/.vuepress/.cache docs/.vuepress/dist",
     "docs:dev": "vuepress-cli dev docs --clean-cache --clean-temp",
     "docs:dev-webpack": "DOCS_BUNDLER=webpack pnpm docs:dev",
+    "docs:lint": "prettier --check --write .",
     "docs:serve": "anywhere -s -h localhost -d docs/.vuepress/dist"
   },
   "commitlint": {