\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.67211545,{"description":3157,"labels":3158,"number":3163,"owner":3149,"repository":3150,"state":3151,"title":3164,"updated_at":3165,"url":3166,"score":3167},"### Describe the bug\r\n\r\n当我在使用动态路由的功能的时候,开发状态下是正常运行的,如下方的配置\r\n\r\n\r\n\r\n\r\n`export default {\r\n paths() {\r\n return [\r\n { params: { pkg: '../svgui/important/' }},\r\n { params: { pkg: '../toolkit/important/' }},\r\n ]\r\n }\r\n}`\r\n\r\n我在当前目录的上级中的两个目录中分别用当前的md文件生成了两个文件,开发环境一切正常。\r\n但打包之后,对应目录的文件生成了,但是内容却是404。\r\n\r\n### Reproduction\r\n\r\n无\r\n\r\n### Expected behavior\r\n\r\n希望能改进后,开发环境和生产环境表现一致。\r\n\r\n### System Info\r\n\r\n```Text\r\nnode 18.19 \r\nwindows\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.",[3159,3160],{"name":3146,"color":3147},{"name":3161,"color":3162},"stale","ededed",4200,"动态路由打包后遇到的bug,开发环境正常","2024-10-26T17:17:22Z","https://github.com/vuejs/vitepress/issues/4200",0.6866382,{"description":3169,"labels":3170,"number":3172,"owner":3149,"repository":3150,"state":3173,"title":3174,"updated_at":3175,"url":3176,"score":3177},"### 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,"closed","`postcssIsolateStyles` type issue with inline postcss plugin config in `vite` configs","2023-09-05T00:04:09Z","https://github.com/vuejs/vitepress/issues/2867",0.6163375,{"description":3179,"labels":3180,"number":3181,"owner":3149,"repository":3150,"state":3173,"title":3182,"updated_at":3183,"url":3184,"score":3185},"### Describe the bug\n\ncontent 部分没有 overflow:hidden 导致很长的滚动条(也有可能是我的图片太大?)\r\n\r\n[github here](https://github.com/Mt-Youya/DeepLearning-500-questions)\r\n\r\n[site here](https://deeplearning-500-questions.pages.dev/zh-cn/ch02_%E6%9C%BA%E5%99%A8%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80/%E7%AC%AC%E4%BA%8C%E7%AB%A0_%E6%9C%BA%E5%99%A8%E5%AD%A6%E4%B9%A0%E5%9F%BA%E7%A1%80.html)\n\n### Reproduction\n\n我fork 别人的仓库,不是我自己写的, 它原本用的是 docsify 我想提个pr用vitepress 试试,然后就出现了这个bug\n\n### Expected behavior\n\n没有滚动条\n\n### System Info\n\n```Text\nVersion 122.0.6261.112 (Official Build) (64-bit)\r\nwin11\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.",[],3644,"CSS bug","2024-03-19T00:07:30Z","https://github.com/vuejs/vitepress/issues/3644",0.6476915,{"description":3187,"labels":3188,"number":3190,"owner":3149,"repository":3150,"state":3173,"title":3191,"updated_at":3192,"url":3193,"score":3194},"### Describe the bug\n\nIt occur unexpected css style when I use doc theme,just CSS pollution cause the label selector `.vp-doc table`.\r\n\r\n\n\n### Reproduction\n\n```txt\r\n---\r\nlayout: doc\r\n---\r\n\r\n\u003Cscript setup>\r\n\r\nimport {ElTable} from 'element-plus'\r\n\u003Cscript>\r\n\r\n\u003Cel-table>\u003C/el-table>\r\n\r\n```\r\n`el-table` style is unexpected because `.vp-doc table` `.vp-doc td` `.vp-doc tr` selectors.\n\n### Expected behavior\n\n`el-table` or other html tags have browser's default style in doc theme.\n\n### System Info\n\n```Text\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.49 GB / 15.73 GB\r\n Binaries:\r\n Node: 18.15.0 - D:\\Program Files (x86)\\node\\18\\node.EXE\r\n Yarn: 1.22.19 - D:\\Program Files (x86)\\node\\18\\yarn.CMD\r\n npm: 9.5.0 - D:\\Program Files (x86)\\node\\18\\npm.CMD\r\n pnpm: 8.6.8 - D:\\Program Files (x86)\\node\\18\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22621.2283.0), Chromium (114.0.1823.67)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.13 => 1.0.0-rc.13\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.",[3189],{"name":3146,"color":3147},3077,"unexpected css style","2023-10-25T00:05:22Z","https://github.com/vuejs/vitepress/issues/3077",0.6628712,{"description":3196,"labels":3197,"number":3199,"owner":3149,"repository":3150,"state":3173,"title":3200,"updated_at":3201,"url":3202,"score":3203},"### Describe the bug\n\nWhen a selector includes an escaped colon (common in Tailwind utilities) the `postcssIsolateStyles` plugin thinks the colon starts a pseudo-class and inserts `:not(:where(.vp-raw, .vp-raw *))` in the wrong place.\n\nFor example, the [vitepress-openapi](https://github.com/enzonotario/vitepress-openapi) plugin uses tailwindcss utils like this one:\n\n```html\n\u003Cbutton class=\"disabled:opacity-50 ...\">\n```\n\nTailwind generates:\n\n```css\n.disabled\\:opacity-50:disabled { ... }\n```\n\n### ❌ Current output of `postcssIsolateStyles`:\n\n```css\n.disabled\\:not(:where(.vp-raw, .vp-raw *)):opacity-50:disabled { … }\n```\n\n### ✅ Expected output:\n\n```css\n.disabled\\:opacity-50:not(:where(.vp-raw, .vp-raw *)):disabled { … }\n```\n\n### ☑️ Fix\n\n`transform` function passed to the `postcssPrefixSelector` in `postcssIsolateStyles` must split the selector only on non-escaped colons.\n\nI am preparing PR with implementation and tests\n\n### Reproduction\n\n1. Use any `.css` file with escaped colons in selectors. In my case, it was [vitepress-openapi](https://github.com/enzonotario/vitepress-openapi), which ships with `vitepress-openapi.css`.\n2. Isolate classes by adding this to your `docs/postcss.config.mjs`:\n\n```ts\nimport { postcssIsolateStyles } from 'vitepress';\nexport default {\n plugins: [\n postcssIsolateStyles({\n includeFiles: [/vitepress-openapi\\.css/],\n }),\n ],\n};\n```\n\n3. Notice that classes with escaped colons, like `.disabled\\:opacity-50:disabled`, got messed up:\n instead of\n `.disabled\\:opacity-50:not(:where(.vp-raw, .vp-raw *)):disabled`\n we got\n `.disabled\\:not(:where(.vp-raw, .vp-raw *)):opacity-50:disabled`,\n which is not valid CSS.\n\n\n### Expected behavior\n\n`postcssIsolateStyles` should handle selectors with escaped colon (`.foo\\:bar`) properly.\n\n### System Info\n\n```Text\nSystem:\n OS: Windows 11 10.0.26100\n CPU: (20) x64 12th Gen Intel(R) Core(TM) i7-12700H\n Memory: 17.99 GB / 63.67 GB\n Binaries:\n Node: 22.11.0 - C:\\Program Files\\nodejs\\node.EXE\n Yarn: 1.22.22 - ~\\AppData\\Roaming\\npm\\yarn.CMD\n npm: 11.4.1 - C:\\Program Files\\nodejs\\npm.CMD\n pnpm: 10.12.2 - ~\\AppData\\Local\\pnpm\\pnpm.EXE\n Browsers:\n Edge: Chromium (130.0.2849.80)\n```\n\n### Additional context\n\nPR with implementation and tests is coming\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.",[3198],{"name":3146,"color":3147},4829,"`postcssIsolateStyles` plugin produces invalid CSS when selector contains escaped colon (`:`)","2025-07-07T17:11:49Z","https://github.com/vuejs/vitepress/issues/4829",0.6671647,{"description":3205,"labels":3206,"number":3210,"owner":3149,"repository":3150,"state":3173,"title":3211,"updated_at":3212,"url":3213,"score":3214},"### Describe the bug\n\nUsing the browser with resolution 1280px, there is an media query overlap for the toc \"On this page\" section.\r\n\r\nThe section is shown above and aside.\r\n\r\n\r\n\n\n### Reproduction\n\nSize browser to 1280px\n\n### Expected behavior\n\nThe top \"On this page\" section is hidden while shown aside.\n\n### System Info\n\n```sh\nSystem:\r\n OS: Windows 10 10.0.22621\r\n CPU: (12) x64 AMD Ryzen 5 3600 6-Core Processor\r\n Memory: 5.87 GB / 15.95 GB\r\n Binaries:\r\n Node: 18.16.1 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 115.0.5790.99\r\n Edge: Spartan (44.22621.1992.0), Chromium (114.0.1823.82)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.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.",[3207],{"name":3208,"color":3209},"theme","0754FB",2668,"Theme cosmetic issue showing \"On this page\" twice at 1280px breakpoint","2023-07-30T00:04:46Z","https://github.com/vuejs/vitepress/issues/2668",0.6728725,{"description":3216,"labels":3217,"number":3221,"owner":3149,"repository":3150,"state":3173,"title":3222,"updated_at":3223,"url":3224,"score":3225},"### 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.",[3218],{"name":3219,"color":3220},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.6740844,{"description":3227,"labels":3228,"number":3230,"owner":3149,"repository":3150,"state":3173,"title":3231,"updated_at":3232,"url":3233,"score":3234},"### Describe the bug\n\n\r\n\r\n打包报错css问题,css没有任何问题,theme里全局引入组件库的,版本\"vitepress\": \"1.0.0-beta.1\"\n\n### Reproduction\n\nv \"vitepress\": \"1.0.0-beta.1\"\n\n### Expected behavior\n\n正常打包\n\n### System Info\n\n```sh\nnpm run build\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.",[3229],{"name":3146,"color":3147},2439,"打包报错Unexpected token '.' 问题","2023-06-08T00:04:08Z","https://github.com/vuejs/vitepress/issues/2439",0.6757114,{"description":3236,"labels":3237,"number":3239,"owner":3149,"repository":3150,"state":3173,"title":3240,"updated_at":3241,"url":3242,"score":3243},"### 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.",[3238],{"name":3146,"color":3147},362,"Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.6762544,["Reactive",3245],{},["Set"],["ShallowReactive",3248],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fEXAdZwnM4gElYu4nRHCgn3kxej4frQTLCQ7qVoyalZA":-1},"/vuejs/vitepress/2868"]