\n\n### Expected behavior\n\nI hope to use SVG and other methods instead of using masks to display icons, which can avoid frequent redrawing\n\n### System Info\n\n```Text\n\"vitepress\": \"^1.6.4\",\n```\n\n### Additional context\n\n\u003Cimg width=\"2559\" height=\"1042\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/39db5990-f3ee-47bb-8bcf-49272a1918f4\" />\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.",[3145],{"name":3146,"color":3147},"bug: pending triage","e99695",4917,"vuejs","vitepress","open","Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.6711438,{"description":3157,"labels":3158,"number":3162,"owner":3149,"repository":3150,"state":3163,"title":3164,"updated_at":3165,"url":3166,"score":3167},"### Describe the bug\n\n使用官方文档的部署脚本成功部署到Github Pages之后,此时如果配置使用自定义域名的话,访问时样式会丢失\n\n### Reproduction\n\n1. 博客目录结构如下所示:\u003Cbr />\r\n2. 配置文件如下所示:\u003Cbr /> \n\n### Expected behavior\n\n使用 Github 自带的 https://xihuanxiaorang.github.io/docs/ 访问就没有任何问题,如果是使用自定义域名 https://docs.xiaorang.fun/ 的话,样式就会丢失\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (4) x64 Intel(R) Core(TM) i5-5200U CPU @ 2.20GHz\r\n Memory: 659.73 MB / 3.92 GB\r\n Binaries:\r\n Node: 20.11.0 - E:\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - E:\\nodejs\\node_global\\yarn.CMD\r\n npm: 10.2.4 - E:\\nodejs\\npm.CMD\r\n pnpm: 8.14.3 - E:\\nodejs\\node_global\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.144)\r\n Internet Explorer: 11.0.19041.3636\r\n npmPackages:\r\n vitepress: 1.0.0-rc.40 => 1.0.0-rc.40\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.",[3159],{"name":3160,"color":3161},"question","5D5FAE",3513,"closed","部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.6369592,{"description":3169,"labels":3170,"number":3172,"owner":3149,"repository":3150,"state":3163,"title":3173,"updated_at":3174,"url":3175,"score":3176},"### Describe the bug\r\n\r\n\r\n`config.ts`\r\n```ts\r\nexport default defineConfig({\r\n vite: {\r\n css: {\r\n postcss: {\r\n plugins: [\r\n postcssIsolateStyles({\r\n includeFiles: [/vp-doc\\.css/]\r\n }),\r\n ],\r\n },\r\n }\r\n})\r\n```\r\n\r\n### Reproduction\r\n\r\nSee above\r\n\r\n### Expected behavior\r\n\r\nNo error\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: 38.35 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.1 - C:\\NodeJS\\npm.CMD\r\n pnpm: 8.7.0 - C:\\NodeJS\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (116.0.1938.62)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.9 => 1.0.0-rc.9\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.",[3171],{"name":3146,"color":3147},2867,"`postcssIsolateStyles` type issue with inline postcss plugin config in `vite` configs","2023-09-05T00:04:09Z","https://github.com/vuejs/vitepress/issues/2867",0.6440275,{"description":3178,"labels":3179,"number":3181,"owner":3149,"repository":3150,"state":3163,"title":3182,"updated_at":3183,"url":3184,"score":3185},"### Describe the bug\r\n\r\n指定端口号后热更新失效,恢复默认之后热更新依旧不生效\r\n\r\n### Reproduction\r\n\r\nvitepress dev docs --host --port 9999\r\n\r\n### Expected behavior\r\n\r\n热更新生效\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem: \r\n OS: Windows 10 10.0.19044 \r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11800H @ 2.30GHz\r\n Memory: 44.27 GB / 63.71 GB \r\n Binaries: \r\n Node: 14.18.2 - C:\\Program Files\\nodejs\\node.EXE \r\n Yarn: 1.22.19 - C:\\Program Files (x86)\\Yarn\\bin\\yarn.CMD \r\n npm: 6.14.15 - C:\\Program Files\\nodejs\\npm.CMD \r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (112.0.1722.68)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.75 => 1.0.0-alpha.75\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.",[3180],{"name":3146,"color":3147},2349,"热更新","2023-05-24T00:03:54Z","https://github.com/vuejs/vitepress/issues/2349",0.6472601,{"description":3187,"labels":3188,"number":3190,"owner":3149,"repository":3150,"state":3163,"title":3191,"updated_at":3192,"url":3193,"score":3194},"### Describe the bug\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nyarn add vitepress\r\n\r\nedit package.json\r\n\r\n~~~\r\n \"scripts\": {\r\n \"docs:dev\": \"vitepress dev docs\",\r\n \"docs:build\": \"vitepress build docs\",\r\n \"docs:serve\": \"vitepress serve docs\"\r\n }\r\n~~~\r\n\r\nyarn docs:dev\r\n\r\n### Expected behavior\r\n\r\nnormal display\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: Windows 10 10.0.17763\r\n CPU: (8) x64 Intel(R) Xeon(R) CPU E3-1230 V2 @ 3.30GHz\r\n Memory: 3.25 GB / 7.93 GB\r\n Binaries:\r\n Node: 16.5.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.10 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 7.20.5 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 92.0.4515.107\r\n Edge: Spartan (44.17763.831.0)\r\n Internet Explorer: 11.0.17763.771\r\n npmPackages:\r\n vitepress: ^0.16.1 => 0.16.1\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] Follow our [Code of Conduct](https://vuejs.org/coc)\r\n- [X] Read the [docs](https://vitepress.vuejs.org/).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3189],{"name":3146,"color":3147},362,"Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.6527736,{"description":3196,"labels":3197,"number":3199,"owner":3149,"repository":3150,"state":3163,"title":3200,"updated_at":3201,"url":3202,"score":3203},"### Describe the bug\n\n版本:\"vitepress\": \"^1.0.0-alpha.35\", \r\n里面没有多余的东西。就是按照官网https://vitepress.vuejs.org/guide/getting-started 走到了第三步。然后将 index.md 的内容添加了 {1}\r\n\r\n\r\n\r\n\n\n### Reproduction\n\n按照官网https://vitepress.vuejs.org/guide/getting-started 走到了第三步。然后将 index.md 的内容添加了 {1}\n\n### Expected behavior\n\n正常渲染 {1} 标签的内容\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22621\r\n CPU: (20) x64 12th Gen Intel(R) Core(TM) i7-12700H\r\n Memory: 1.50 GB / 15.73 GB\r\n Binaries:\r\n Node: 16.15.1 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.11.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22621.963.0), Chromium (108.0.1462.76)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.35 => 1.0.0-alpha.35\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.",[3198],{"name":3146,"color":3147},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.65290326,{"description":3205,"labels":3206,"number":3208,"owner":3149,"repository":3150,"state":3163,"title":3209,"updated_at":3210,"url":3211,"score":3212},"### Describe the bug\n\n路由中中文锚点刷新时由于编码导致报错\r\n\r\n\u003Cimg width=\"1263\" alt=\"Snipaste_2023-03-15_13-14-37\" src=\"https://user-images.githubusercontent.com/37688666/225213537-b55d97a4-69ca-4c7a-9077-ec4b82b412c5.png\">\r\n\n\n### Reproduction\n\n无\n\n### Expected behavior\n\n支持中文锚点\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i7-11800H @ 2.30GHz\r\n Memory: 40.44 GB / 63.71 GB\r\n Binaries:\r\n Node: 14.18.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files (x86)\\Yarn\\bin\\yarn.CMD\r\n npm: 6.14.15 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.69)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: * => 1.0.0-alpha.56\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.",[3207],{"name":3146,"color":3147},2089,"锚点链接中文错误","2023-03-23T00:04:21Z","https://github.com/vuejs/vitepress/issues/2089",0.6556981,{"description":3214,"labels":3215,"number":3217,"owner":3149,"repository":3150,"state":3163,"title":3218,"updated_at":3219,"url":3220,"score":3221},"### Describe the bug\n\nHover state on link in `.vp-doc` is always matched, seems `:hover` is being truncated.\r\n\r\n\r\nCopy button in code block is also messed up.\r\n\r\n\r\n\r\nTable style messed up as well.\r\n\r\nI guess there's a lot more...\n\n### Reproduction\n\nIn `config.ts`:\r\n```ts\r\nexport default defineConfig({\r\n vite: {\r\n css: {\r\n postcss: {\r\n plugins: [\r\n postcssIsolateStyles({\r\n includeFiles: [/vp-doc\\.css/]\r\n }),\r\n ],\r\n },\r\n }\r\n})\r\n```\r\n\r\nI would write one if required, but since my above example is pretty easy to reproduce, I'll leave it blank here.\n\n### Expected behavior\n\nStyle not messed up\r\n\r\n (NOTE: it's working properly if I use `postcss-prefix-selector` straight away instead of using the one from vitepress package)\n\n### System Info\n\n```sh\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: 38.35 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.1 - C:\\NodeJS\\npm.CMD\r\n pnpm: 8.7.0 - C:\\NodeJS\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (116.0.1938.62)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.9 => 1.0.0-rc.9\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.",[3216],{"name":3146,"color":3147},2868,"`postcssIsolateStyles` mess up original styles","2023-09-05T00:04:08Z","https://github.com/vuejs/vitepress/issues/2868",0.6608256,{"description":3223,"labels":3224,"number":3237,"owner":3149,"repository":3150,"state":3163,"title":3238,"updated_at":3239,"url":3240,"score":3241},"### 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.",[3225,3228,3231,3234],{"name":3226,"color":3227},"help wanted","008672",{"name":3229,"color":3230},"build","377ba8",{"name":3232,"color":3233},"upstream","BF29ED",{"name":3235,"color":3236},"stale","ededed",4098,"Styling discrepancies between dev and build","2025-01-05T04:42:47Z","https://github.com/vuejs/vitepress/issues/4098",0.6620697,{"description":3243,"labels":3244,"number":3248,"owner":3149,"repository":3150,"state":3163,"title":3249,"updated_at":3250,"url":3251,"score":3252},"### Describe the bug\n\n当没有sidebar,有footer和outline时,滚动轴在底部,outline将会显示异常\n\n### Reproduction\n\n\r\n\n\n### Expected behavior\n\n修复outline显示异常,固定在原位不动\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22000\r\n CPU: (8) x64 11th Gen Intel(R) Core(TM) i7-1165G7 @ 2.80GHz\r\n Memory: 8.82 GB / 15.69 GB\r\n Binaries:\r\n Node: 16.17.0 - D:\\developer_tools\\nodejs\\node.EXE\r\n npm: 8.19.1 - D:\\developer_tools\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22000.120.0)\r\n Internet Explorer: 11.0.22000.120\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.",[3245],{"name":3246,"color":3247},"theme","0754FB",1464,"outline显示异常","2023-01-21T14:22:49Z","https://github.com/vuejs/vitepress/issues/1464",0.66266704,["Reactive",3254],{},["Set"],["ShallowReactive",3257],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fsyG623cj5mm4lsCijJHljYMVYP-WTe6Az6HDcFFCb3M":-1},"/vuejs/vitepress/2668"]