\r\n title: Feature A\r\n details: Lorem ipsum dolor sit amet, consectetur adipiscing elit\r\n```\r\n\r\nCheck the feature icon type\r\n```ts\r\ntype FeatureIcon =\r\n | string\r\n | { src: string; alt?: string; width?: string; height: string }\r\n | {\r\n light: string\r\n dark: string\r\n alt?: string\r\n width?: string\r\n height: string\r\n }\r\n```\r\n\r\nI refer to the render logic, use `v-html` render the icon.\r\nDisplay well in `dev` environment, but shows errors in `prod` environment.\r\n\r\n| dev | build |\r\n| ----------- | ----------- |\r\n|  |  |\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/github/zyyv/vitepress-unocss-issue\r\n\r\n- Display right run `pnpm dev`\r\n- Display error run `pnpm build && pnpm preview`\r\n\r\n### Expected behavior\r\n\r\nDev and build behave the same\r\n\r\n### System Info\r\n\r\n```Text\r\nlatest\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n_No response_\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.",[3040,3043,3046],{"name":3041,"color":3042},"build","377ba8",{"name":3044,"color":3045},"has-workaround","1B4515",{"name":3027,"color":3028},4045,"SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.7858985,{"description":3053,"labels":3054,"number":3055,"owner":3030,"repository":3031,"state":3056,"title":3057,"updated_at":3058,"url":3059,"score":3060},"### Is your feature request related to a problem? Please describe.\n\nthe right navigation isn't set to highlight in light mode as left. The current highlight is not very obvious\r\n\r\n\r\n\r\n\n\n### Describe the solution you'd like\n\nthe style is set to the same as left nav\r\n\r\n\r\n\n\n### Describe alternatives you've considered\n\n_No response_\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.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.",[],2899,"closed","Can the right navigation be set to highlight","2023-09-12T00:04:16Z","https://github.com/vuejs/vitepress/issues/2899",0.74319476,{"description":3062,"labels":3063,"number":3067,"owner":3030,"repository":3031,"state":3056,"title":3068,"updated_at":3069,"url":3070,"score":3071},"### 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.",[3064],{"name":3065,"color":3066},"question","5D5FAE",2627,"How should I trace build error?","2023-07-24T00:04:51Z","https://github.com/vuejs/vitepress/issues/2627",0.7543047,{"description":3073,"labels":3074,"number":3078,"owner":3030,"repository":3031,"state":3056,"title":3079,"updated_at":3080,"url":3081,"score":3082},"### Describe the bug\n\n1. When in MPA mode, Normal in development mode, no outline in production environment:\r\n\r\nLocal use: pnpm exec vitepress dev dist --mpa\r\n\r\n\r\non linux server use : pnpm exec vitepress build dist --mpa\r\n\r\n\n\n### Reproduction\n\nwindows 10\r\n\r\nC:\\Users\\test\\Desktop\\tmp>node -v\r\nv18.16.1\r\n\r\nC:\\Users\\test\\Desktop\\tmp>npm -v\r\n9.5.1\r\n\r\nvitepress version: 1.0.0 beta.3\n\n### Expected behavior\n\nwindows 10\r\n\r\nC:\\Users\\test\\Desktop\\tmp>node -v\r\nv18.16.1\r\n\r\nC:\\Users\\test\\Desktop\\tmp>npm -v\r\n9.5.1\r\n\r\nvitepress version: 1.0.0 beta.3\n\n### System Info\n\n```sh\nwindows 10\r\n\r\nC:\\Users\\test\\Desktop\\tmp>node -v\r\nv18.16.1\r\n\r\nC:\\Users\\test\\Desktop\\tmp>npm -v\r\n9.5.1\r\n\r\nvitepress version: 1.0.0 beta.3\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.",[3075],{"name":3076,"color":3077},"bug: pending triage","e99695",2552,"MPA MODE BUGS","2023-07-05T00:05:12Z","https://github.com/vuejs/vitepress/issues/2552",0.7579152,{"description":3084,"labels":3085,"number":3094,"owner":3030,"repository":3031,"state":3056,"title":3095,"updated_at":3096,"url":3097,"score":3098},"### Describe the bug\n\nJust like the Vite docs, I use custom styles in the `index.md` file using `\u003Cstyle module>`. I also use custom components in which I use `\u003Cstyle scoped>`.\r\n\r\nSince I updated from version `1.0.0` to the latest one (the one in the StackBlitz), the built page's styles are broken. In the dev preview everything looks like expected.\n\n### Reproduction\n\nOpen the StackBlitz Demo with this [link](https://stackblitz.com/edit/vite-1qtmk8?file=docs%2Findex.md).\r\n\r\nIf it does not run automatically, run `npm install && npm run dev`. It should look something like this:\r\n\r\n\r\n\r\nThen run `npm run docs:build && npm run docs:preview` and it will look like this:\r\n\r\n\r\n\r\nAs you can see, the hero image and its background are different and the cards are different as well.\n\n### Expected behavior\n\nI expected the built version to look just like the dev preview (or at least very close).\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (12) x64 AMD Ryzen 5 5500U with Radeon Graphics\r\n Memory: 6.45 GB / 15.35 GB\r\n Binaries:\r\n Node: 21.2.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 10.5.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 9.1.2 - ~\\AppData\\Roaming\\npm\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (127.0.2651.74)\r\n Internet Explorer: 11.0.19041.4355\r\n npmPackages:\r\n vitepress: ^1.3.1 => 1.3.1\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.",[3086,3089,3090,3093],{"name":3087,"color":3088},"help wanted","008672",{"name":3041,"color":3042},{"name":3091,"color":3092},"upstream","BF29ED",{"name":3027,"color":3028},4098,"Styling discrepancies between dev and build","2025-01-05T04:42:47Z","https://github.com/vuejs/vitepress/issues/4098",0.7584554,{"description":3100,"labels":3101,"number":3102,"owner":3030,"repository":3031,"state":3056,"title":3103,"updated_at":3104,"url":3105,"score":3106},"### Is your feature request related to a problem? Please describe.\n\nI have many pages, so how to partially build.\n\n### Describe the solution you'd like\n\nI have to build all the pages even I only add a new one?\n\n### Describe alternatives you've considered\n\n_No response_\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.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.",[],4182,"how to partially build","2024-09-14T04:42:49Z","https://github.com/vuejs/vitepress/issues/4182",0.7748224,{"description":3108,"labels":3109,"number":3111,"owner":3030,"repository":3031,"state":3056,"title":3112,"updated_at":3113,"url":3114,"score":3115},"### Describe the bug\n\n在 xx.md 文件中输入以下文档会报错:\r\n## 测试文档\r\n\r\n\r\n> \u003Cn>y = 密钥在 n 年后过期\r\n> 密钥的有效期限是?(0)\r\n\r\n\r\n11\r\n22\r\n\r\n33\n\n### Reproduction\n\n输入以上内容,编译错误\n\n### Expected behavior\n\n能够正常的编译, \n\n### System Info\n\n```shell\n17:38:38 [vite] Internal server error: Element is missing end tag.\r\n Plugin: vite:vue\r\n File: D:/pro/doc/my-docs/docs/l-note/GPG入门教程.md\r\n 6 | \r\n 7 | \r\n 8 | 11\r\n | ^\r\n 9 | 22\r\n 10 | \r\n at createCompilerError (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:19:19)\r\n at emitError (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1602:29)\r\n at parseElement (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1154:9)\r\n at parseChildren (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1133:22)\r\n at parseChildren (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1133:22)\r\n at parseChildren (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1133:22)\r\n at parseChildren (D:\\pro\\doc\\my-docs\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\n```\n\n\n### Additional context\n\n\r\n\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.",[3110],{"name":3076,"color":3077},1470,"容错率太低了, 以下文档也会进行报错。","2023-01-23T00:04:14Z","https://github.com/vuejs/vitepress/issues/1470",0.77563614,{"description":3117,"labels":3118,"number":3122,"owner":3030,"repository":3031,"state":3056,"title":3123,"updated_at":3124,"url":3125,"score":3126},"### Describe the bug\n\nIn development mode, markdown under node_modules will be parsed\n\n### Reproduction\n\nAdd a markdown file index.md in node_modules under docs and then visit localhost:5173/node_modules/.md file is parsed\n\n### Expected behavior\n\nexpect not to be parsed\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22000\r\n CPU: (12) x64 Intel(R) Core(TM) i5-10600KF CPU @ 4.10GHz\r\n Memory: 18.07 GB / 31.87 GB\r\n Binaries:\r\n Node: 16.19.1 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 8.19.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22000.120.0), Chromium (111.0.1661.51)\r\n Internet Explorer: 11.0.22000.120\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.63 => 1.0.0-alpha.63\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.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3119],{"name":3120,"color":3121},"need more info","bdbefc",2156,"In development mode, markdown under node_modules will be parsed","2023-04-24T00:04:08Z","https://github.com/vuejs/vitepress/issues/2156",0.7799936,{"description":3128,"labels":3129,"number":3132,"owner":3030,"repository":3031,"state":3056,"title":3133,"updated_at":3134,"url":3135,"score":3136},"### Describe the bug\n\n### dependencies\r\n\r\n`pnpm add @chenwei02/qy-element`\r\n> `@chenwei02/qy-element` has svg-icon component. svg files builded by vite-plugin-svg-icons.\r\n\r\n### docs\r\n`vitepress dev docs` is ok\r\n`vitepress build docs` then deploy to gh-pages, *.svg icon was blank.\r\n\r\n### Problem\r\nvitepress build docs . something is wrong.\r\n\r\n### Help\r\nI need help\n\n### Reproduction\n\npnpm add @chenwei02/qy-element\r\n\r\n*.md\r\n\u003Cqy-icon name=\"close\">\r\n\r\nvitepress build docs.\n\n### Expected behavior\n\nevery thing is ok.\n\n### System Info\n\n```sh\nvitepress : 1.0.0-alpha.64\r\n@chenwei02/qy-element: 1.0.2-p1\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.",[3130,3131],{"name":3076,"color":3077},{"name":3027,"color":3028},2385,"Vitepress build Problem","2023-08-18T00:04:08Z","https://github.com/vuejs/vitepress/issues/2385",0.78158027,["Reactive",3138],{},["Set"],["ShallowReactive",3141],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fcRhAsS3F0qSRVtpBQsXYbtJGhQAmYSNqtNqOUmymb-k":-1},"/vuejs/vitepress/1016"]