|\u003Cimg width=\"612\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/e408b294-1471-4703-b7b4-8d21a6ccd5be\" />|\n|[preview link](https://deploy-preview-4660--vitepress-docs.netlify.app/404)|[preview link](https://deploy-preview-4660--vitepress-docs.netlify.app/zh/404)|\n\nThis is currently **impossible** because `NotFound.vue` does not provide an locale configuration interface.\nAfter introducing the proposed feature, it **automatically** supports multi-language - _without changing one line of code inside it_!\n\n### Validations\n\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [x] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[],4659,"closed","Multi-layer hierarchical configuration overloading","2025-04-15T17:13:25Z","https://github.com/vuejs/vitepress/issues/4659",0.72321767,{"description":2877,"labels":2878,"number":2879,"owner":2860,"repository":2861,"state":2871,"title":2880,"updated_at":2881,"url":2882,"score":2883},"### Describe the bug\n\n在我编写一个.md文件时我是这么写的:\r\n\r\n```\r\n\u003Cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/NoNameGMM/SignInForMiraiMC?style=flat&label=License\r\n\"/>\r\n\u003Cimg alt=\"Minecraft Version\" src=\"https://img.shields.io/badge/Minecraft-1.8--1.20-blue?style=flat&color=green\"/>\r\n\u003Cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/NoNameGMM/SignInForMiraiMC?style=flat&label=Release\"/>\r\n```\r\n\r\n正常来说应该是这样:\r\n\u003Cimg width=\"249\" alt=\"photo1\" src=\"https://github.com/vuejs/vitepress/assets/109721871/d5c41be5-f3df-43f7-bd88-a2f12a11490f\">\r\n\r\n可是vitepress的效果是:\r\n\u003Cimg width=\"107\" alt=\"屏幕截图 2024-03-03 200157\" src=\"https://github.com/vuejs/vitepress/assets/109721871/a5b20517-2e3f-4fb0-9390-1f06cdbbebd6\">\r\n\r\n\r\n\n\n### Reproduction\n\n同上\n\n### Expected behavior\n\n我想要实现正常markdown的效果\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (16) x64 AMD Ryzen 7 5800H with Radeon Graphics\r\n Memory: 1.68 GB / 13.86 GB\r\n Binaries:\r\n Node: 20.10.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 10.2.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.15.4 - ~\\AppData\\Roaming\\npm\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (122.0.2365.59)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.44 => 1.0.0-rc.44\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[],3631,"使用shields.io徽标时图片自动换行","2024-03-11T00:04:39Z","https://github.com/vuejs/vitepress/issues/3631",0.7342027,{"description":2885,"labels":2886,"number":2890,"owner":2860,"repository":2861,"state":2871,"title":2891,"updated_at":2892,"url":2893,"score":2894},"### Describe the bug\n\n- Local\n\n\n\n- VitePress\n\n\n### Reproduction\n\nFor example:\n\n```\n## jifa-jpackage.{sh | bat}\n```\n\n### Expected behavior\n\nnormal display\n\n### System Info\n\n```Text\nSystem:\n OS: macOS 15.4\n CPU: (10) arm64 Apple M1 Pro\n Memory: 108.19 MB / 16.00 GB\n Shell: 5.9 - /bin/zsh\n Binaries:\n Node: 20.15.0 - ~/.nvm/versions/node/v20.15.0/bin/node\n npm: 10.9.0 - ~/.nvm/versions/node/v20.15.0/bin/npm\n Browsers:\n Chrome: 133.0.6943.55\n Edge: 133.0.3065.69\n Safari: 18.4\n```\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2887],{"name":2888,"color":2889},"bug: pending triage","e99695",4670,"Parsing exception when there is a '|' in the title","2025-04-03T03:23:04Z","https://github.com/vuejs/vitepress/issues/4670",0.73988074,{"description":2896,"labels":2897,"number":2898,"owner":2860,"repository":2861,"state":2871,"title":2899,"updated_at":2900,"url":2901,"score":2902},"### Discussed in https://github.com/vuejs/vitepress/discussions/595\r\n\r\n\u003Cdiv type='discussions-op-text'>\r\n\r\n\u003Csup>Originally posted by **Roman-00** April 4, 2022\u003C/sup>\r\nGood afternoon, \r\nI ran into such a problem that when building the project, he swears on the window\r\n\r\n\r\n.\r\n\r\nPlease tell me what is the problem?\u003C/div>",[],596,"Build error, window not defined","2023-01-21T14:33:58Z","https://github.com/vuejs/vitepress/issues/596",0.7517816,{"description":2904,"labels":2905,"number":2906,"owner":2860,"repository":2861,"state":2871,"title":2907,"updated_at":2908,"url":2909,"score":2910},"I notice that VitePress uses the shiki's `transformerNotationFocus()` with an option of:\n\nhttps://github.com/vuejs/vitepress/blob/21f24b9994ea4807ac7e0be38408e9aaa3abe8a9/src/node/markdown/plugins/highlight.ts#L78-L81\n\nhowever the default value set by shiki is :\n```\nconst {\n classActiveLine = 'focused',\n classActivePre = 'has-focused',\n} = options\n```\n\nIs there any particular reasons for this?",[],4716,"question about shiki's `transformerNotationFocus()` options","2025-04-24T08:58:13Z","https://github.com/vuejs/vitepress/issues/4716",0.75181735,{"description":2912,"labels":2913,"number":2917,"owner":2860,"repository":2861,"state":2871,"title":2918,"updated_at":2919,"url":2920,"score":2921},"### Describe the bug\n\n\r\n\n\n### Reproduction\n\nhttps://github.com/meedfine/server-fs-allow.git\r\ntest win10,win11, it happened\r\n\r\n1. pnpm run docs\r\n2. visit http://localhost:5173/\r\n3.close\r\n4. pnpm run docs\r\nthen will happen,or retry 3,4\r\n\r\n\r\nhttps://user-images.githubusercontent.com/35157761/201807046-c6e534ae-722a-4149-86f0-aab839296381.mp4\r\n\r\n\n\n### Expected behavior\n\nwork well\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19043\r\n CPU: (4) x64 Intel(R) Core(TM) i3-3240 CPU @ 3.40GHz\r\n Memory: 9.72 GB / 15.87 GB\r\n Binaries:\r\n Node: 16.14.2 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 8.5.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 78.0.3904.108\r\n Edge: Spartan (44.19041.1266.0), Chromium (107.0.1418.42)\r\n Internet Explorer: 11.0.19041.1566\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2914],{"name":2915,"color":2916},"build","377ba8",1608,"mono+dev+enhanceApp+fs.server.strict: sometimes run error","2023-01-21T14:20:33Z","https://github.com/vuejs/vitepress/issues/1608",0.7526316,{"description":2923,"labels":2924,"number":2925,"owner":2860,"repository":2861,"state":2871,"title":2926,"updated_at":2927,"url":2928,"score":2929},"https://stackblitz.com/edit/vite-j4njvz?file=docs/.vitepress/config.ts",[],2246,"no active style on the rewrited sidebar item.","2023-04-25T00:04:07Z","https://github.com/vuejs/vitepress/issues/2246",0.75276,{"description":2931,"labels":2932,"number":2936,"owner":2860,"repository":2861,"state":2871,"title":2937,"updated_at":2938,"url":2939,"score":2940},"### Describe the bug\r\n\r\nI'm getting some errors when running `pnpm build`, I guess it's because I should somehow wrap this component causing the error in `\u003CClientOnly />`, but how should I find the exact cause from the error log? It does not provide any useful details (see below screenshot)\r\n\r\n---\r\n\r\nAnother question, as I guess my error is because of this:\r\nShould I wrap `watch()` inside `onMounted()`? or in another word, can I do it? I didn't find any corresponding example in Vue documentation... \r\nSorry if this is a dumb question, as I'm a react guy :(\r\n```vue\r\n\u003Cscript setup lang=\"ts\">\r\nimport { useLocalStorage } from '@vueuse/core';\r\nimport { watch } from 'vue';\r\n\r\nconst nfcapiEnvRef = useLocalStorage('vp-nfcapi-env', 'staging', {\r\n deep: false,\r\n listenToStorageChanges: true,\r\n writeDefaults: true\r\n});\r\n\r\nwatch(nfcapiEnvRef, (value, oldValue) => {\r\n const htmlDataSet = document.documentElement.dataset;\r\n oldValue && (htmlDataSet.nfcapiEnv = oldValue.toLowerCase());\r\n htmlDataSet.nfcapiEnv = value.toLowerCase();\r\n}, { immediate: true });\r\n\u003C/script>\r\n```\r\n\r\n---\r\n\r\nScreenshot of the error:\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nThis is not a bug, but a question\r\n\r\n### Expected behavior\r\n\r\nN/A\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz\r\n Memory: 30.87 GB / 63.84 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\NodeJS\\node.EXE\r\n Yarn: 1.22.19 - C:\\NodeJS\\yarn.CMD\r\n npm: 9.8.0 - C:\\NodeJS\\npm.CMD\r\n pnpm: 8.6.7 - C:\\NodeJS\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (114.0.1823.82)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-beta.5 => 1.0.0-beta.5\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nN/A\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2933],{"name":2934,"color":2935},"question","5D5FAE",2627,"How should I trace build error?","2023-07-24T00:04:51Z","https://github.com/vuejs/vitepress/issues/2627",0.7557738,{"description":2942,"labels":2943,"number":2945,"owner":2860,"repository":2861,"state":2871,"title":2946,"updated_at":2947,"url":2948,"score":2949},"### Describe the bug\n\nIn dev mode, both image filenames contain space or not will serve fine:\r\n\r\n\u003Cimg width=\"1282\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/3367820/acc1113c-6f46-4f0f-abd2-b3a0936792a9\">\r\n\r\n\r\nBut the build will fail when met the image assets whose filename contains space:\r\n\r\n\u003Cimg width=\"1202\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/3367820/329c0a68-86f5-4239-abfb-4335227e6de6\">\r\n\n\n### Reproduction\n\nSee https://stackblitz.com/edit/vite-upxxuh?file=docs%2Fbook%2Fresources%2Ftest%20(1).svg,docs%2Findex.md,docs%2Fbook%2Fresources%2Ftest.svg,\r\n\r\nadd a image filename contains space and build.\n\n### Expected behavior\n\nBuild should succeed.\r\n\r\nIdeally should `decodeURIComponent` when converting `.png]` to code. \r\n\r\nSo the converted code should be like `import image from \"image (1).png\"` instead of `import image from \"image%20(1).png\"`.\n\n### System Info\n\n```sh\n❯ npx envinfo --system --npmPackages vitepress --binaries --browsers\r\n\r\n\r\nNeed to install the following packages:\r\n envinfo@7.10.0\r\nOk to proceed? (y) y\r\n\r\n System:\r\n OS: Linux 5.0 undefined\r\n CPU: (8) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 0 Bytes / 0 Bytes\r\n Shell: 1.0 - /bin/jsh\r\n Binaries:\r\n Node: 16.20.0 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 9.4.2 - /usr/local/bin/npm\r\n pnpm: 8.6.3 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: v1.0.0-beta.5 => 1.0.0-beta.5\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2944],{"name":2888,"color":2889},2596,"Included image filename contains space will make build fail","2023-07-17T00:04:57Z","https://github.com/vuejs/vitepress/issues/2596",0.7569458,["Reactive",2951],{},["Set"],["ShallowReactive",2954],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fKaeZVBMxA1FXuVicarq2sdG1OB2pwAHPLb_ZPhLbAfw":-1},"/vuejs/vitepress/4690"]