\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.712255,{"description":3157,"labels":3158,"number":3159,"owner":3149,"repository":3150,"state":3160,"title":3161,"updated_at":3162,"url":3163,"score":3164},"### Describe the bug\r\n\r\nWhen we have 2 links on navbar containing the former the latter there is a false positive match.\r\n\r\nhttps://github.com/vuejs/vitepress/blob/main/src/client/theme-default/composables/navLink.ts#L19\r\n\r\n### Reproduction\r\n\r\nJust use for example 2 links like this:\r\n\r\n`/somedirectory/svelte` and `/somedirectory/sveltekit`.\r\n\r\nWhen navigating to `/somedirectory/svelte` link, then once in the page, the navbar will show both as `active` (also the parent, in the example `/somedirectory/`).\r\n\r\nClone this repo and checkout `docs/sveltekit` branch: https://github.com/antfu/vite-plugin-pwa (if not found, then the PR 176 will be merged and the branch deleted, just use the `main` branch).\r\n\r\nYou will need `pnpm` installed globally, once cloned and checkout the `docs/sveltekit` branch, go to `docs/.vitepress/theme/composables/navLink.ts` and comment this 2 if statements on line 25 (the code is the same here):\r\n\r\n```ts\r\n if (routePath === '/frameworks/sveltekit' && itemPath === '/frameworks/svelte' && active)\r\n active = false\r\n // fix /examples/sveltekit and /examples/svelte\r\n if (routePath === '/examples/sveltekit' && itemPath === '/examples/svelte' && active)\r\n active = false\r\n```\r\n\r\nRun from root folder `pnpm install && pnpm run build` and then `pnpm run docs` to run the docs site, go to Frameworks nav bar and select Svelte entry, you will see that `Getting Started`, `Svelte` and `SvelteKit` links will be active.\r\n\r\n\r\n### Expected behavior\r\n\r\nShould be only one/two matches.\r\n\r\n### System Info\r\n\r\n```shell\r\nI'm testing with `node16`.\r\n\r\n\r\nnpx envinfo --system --npmPackages vitepress --binaries --browsers\r\n\r\n System:\r\n OS: Windows 10 10.0.19042\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9900K CPU @ 3.60GHz\r\n Memory: 47.82 GB / 63.95 GB\r\n Binaries:\r\n Node: 16.13.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.17 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 8.1.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 96.0.4664.45\r\n Edge: Spartan (44.19041.1266.0), Chromium (96.0.1054.34)\r\n Internet Explorer: 11.0.19041.1202\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.",[],453,"closed","`navLink` module false positives","2023-01-21T16:04:05Z","https://github.com/vuejs/vitepress/issues/453",0.6953083,{"description":3166,"labels":3167,"number":3169,"owner":3149,"repository":3150,"state":3160,"title":3170,"updated_at":3171,"url":3172,"score":3173},"### Describe the bug\n\nI want to use the vue component in vitepress. I have read the documentation on the official website, but when I do it, I encounter an error like this.\r\n```bash\r\n[plugin:vite:vue] Tags with side effect (\u003Cscript> and \u003Cstyle>) are ignored in client component templates.\r\n```\r\n\r\nI don't understand what I'm encountering, I just want to achieve the effect here in this vue document\r\n\r\n> https://cn.vuejs.org/guide/reusability/composables.html#vs-react-hooks\r\n\r\n\r\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-dn63jg?file=docs%2Fhooks%2FuseMouse.js,docs%2Fexample.md\n\n### Expected behavior\n\nThe documentation on the official website makes me understand the difficulty or the need for a better demo?\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (20) x64 13th Gen Intel(R) CoreT i7-13800H\r\n Memory: 17.07 GB / 31.74 GB\r\n Binaries:\r\n Node: 20.11.0 - ~\\AppData\\Local\\pnpm\\node.EXE\r\n npm: 10.2.4 - ~\\AppData\\Local\\pnpm\\npm.CMD\r\n pnpm: 8.14.1 - ~\\AppData\\Local\\pnpm\\pnpm.EXE\r\n Browsers:\r\n Edge: Chromium (120.0.2210.133)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: 1.0.0-rc.39 => 1.0.0-rc.39\n```\n\n\n### Additional context\n\nPlease tell me the correct way to write it, thank you\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.",[3168],{"name":3146,"color":3147},3485,"Using vue to report errors in markdown","2024-01-29T00:04:28Z","https://github.com/vuejs/vitepress/issues/3485",0.6972554,{"description":3175,"labels":3176,"number":3180,"owner":3149,"repository":3150,"state":3160,"title":3181,"updated_at":3182,"url":3183,"score":3184},"### 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.",[3177],{"name":3178,"color":3179},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.6999527,{"description":3186,"labels":3187,"number":3188,"owner":3149,"repository":3150,"state":3160,"title":3189,"updated_at":3190,"url":3191,"score":3192},"### Describe the bug\n\neven without `socialLinks` option set, an empty `vp-icons.css` file will still appear in the build result.\n\n### Reproduction\n\nnone\n\n### Expected behavior\n\n`vp-icons.css` should not be included in the build result when `socialLinks` is not enabled\n\n### System Info\n\n```Text\nnone\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.",[],4869,"empty vp-icons.css file","2025-08-05T13:49:21Z","https://github.com/vuejs/vitepress/issues/4869",0.7001549,{"description":3194,"labels":3195,"number":3197,"owner":3149,"repository":3150,"state":3160,"title":3198,"updated_at":3199,"url":3200,"score":3201},"### 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.",[3196],{"name":3146,"color":3147},2349,"热更新","2023-05-24T00:03:54Z","https://github.com/vuejs/vitepress/issues/2349",0.7044036,{"description":3203,"labels":3204,"number":3206,"owner":3149,"repository":3150,"state":3160,"title":3207,"updated_at":3208,"url":3209,"score":3210},"### 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.",[3205],{"name":3146,"color":3147},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.7046142,{"description":3212,"labels":3213,"number":3215,"owner":3149,"repository":3150,"state":3160,"title":3216,"updated_at":3217,"url":3218,"score":3219},"### Describe the bug\r\n\r\noriginal closed from\r\n- #417\r\n\r\n`__VP_STATIC_END__` is also at bottom of the page.\r\n\r\n### Reproduction\r\n\r\nIt is random, between builds, sometimes `__VP_STATIC_START__` and `__VP_STATIC_END__` will be shown, sometimes no.\r\n\r\nI added some `md` files and forgot to add the `frontmatter` title, it seems adding it will fix the problem, but now it is there again.\r\n\r\nIf we do a hard refresh on page that's showing the `__VP_STATIC_START__` will dissapear, but navigating to another page and back it again `__VP_STATIC_START__` will be displayed.\r\n\r\nThe app is a pwa, but the problem is on the genetared html page, seems there is 2 versions of the md page js, `xxx.js` and `xxx.lean.js`. When the app is loaded using the `xxx.lean.js` version, then `__VP_STATIC_START__` and `__VP_STATIC_END__` will be shown.\r\n\r\nThe repo is here: https://github.com/antfu/vite-plugin-pwa\r\n\r\nI'm using node 15, but should work also with 14.\r\n\r\nThe `vitepress` app can be found on `docs` package on the repo.\r\n\r\nTo test you will need latest `pnpm` installed globally, to generate the `vitepress docs`:\r\n1) clone the repo or download the zip\r\n2) execute `pnpm install && pnpm run build` from root folder\r\n3) run the app\r\n- to start dev, execute `pnpm run docs` from root folder\r\n- to build and run the docs, execute `pnpm run docs:serve` from root folder\r\n\r\n\r\n\r\n### Expected behavior\r\n\r\n`__VP_STATIC_START__` and `__VP_STATIC_END__` should not be displayed.\r\n\r\n### System Info\r\nUsing `vitepress` version `0.19.2`.\r\n\r\nOn dev machine:\r\n\r\n```shell\r\nSystem:\r\n OS: Windows 10 10.0.19042\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9900K CPU @ 3.60GHz\r\n Memory: 49.91 GB / 63.95 GB\r\n Binaries:\r\n Node: 15.11.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.10 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 7.6.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 94.0.4606.81\r\n Edge: Spartan (44.19041.1023.0), Chromium (94.0.992.50)\r\n Internet Explorer: 11.0.19041.1202\r\n```\r\nThe app is deployed on `netlify`.\r\n\r\n### Additional context\r\n\r\nYou can test the app on a private window and so the pwa will not interfere with the problem.\r\n\r\n**TO REPRODUCE THE PROBLEM ON PRODUCTION**\r\n\r\nThe current page with the problem is: https://vite-plugin-pwa.netlify.app/guide/generate.html\r\n\r\nYou can do a hard refresh and check `generate.html` page to see the `guide_generate.md.25c0e6c1.lean.js` is loaded, once the `__VP_STATIC_START__` is shown, clear the network panel, navigate to another page and refresh, clean network panel again, and then back to `Generate Service Worker`, you will see it is using `guide_generate.md.25c0e6c1.js` instead the `lean js` version, and `__VP_STATIC_START__` is gone.\r\n\r\nIf you copy/paste the `js` files for `guide_generate.md.xxx.js` you will see that on lean version there is `__VP_STATIC_START__`.\r\n\r\nA screenshot with the problem on deployed app (https://vite-plugin-pwa.netlify.app/guide/generate.html):\r\n\r\n\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.",[3214],{"name":3146,"color":3147},420,"render `__VP_STATIC_START__`","2023-01-21T16:20:18Z","https://github.com/vuejs/vitepress/issues/420",0.70493656,{"description":3221,"labels":3222,"number":3224,"owner":3149,"repository":3150,"state":3160,"title":3225,"updated_at":3226,"url":3227,"score":3228},"### 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.",[3223],{"name":3146,"color":3147},362,"Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.7052397,{"description":3230,"labels":3231,"number":3233,"owner":3149,"repository":3150,"state":3160,"title":3234,"updated_at":3235,"url":3236,"score":3237},"### Describe the bug\n\nyarn docs:dev\r\n\r\nBrowser display error:\r\n\r\n\n\n### Reproduction\n\nFollow the getting started case, which is https://vitepress.vuejs.org/guide/getting-started.html\n\n### Expected behavior\n\nNormal display index.md\n\n### System Info\n\n```shell\n~~~\r\nPS G:\\vitePress> npx envinfo --system --npmPackages vitepress --binaries --browsers\r\nNeed to install the following packages:\r\n envinfo\r\nOk to proceed? (y) y\r\n\r\n System:\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.91 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.15.6 => 0.15.6\r\n~~~\n```\n\n\n### Additional context\n\n\r\n\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[3232],{"name":3146,"color":3147},359,"Using the simplest example, an error occurred","2023-01-21T16:22:13Z","https://github.com/vuejs/vitepress/issues/359",0.70556873,["Reactive",3239],{},["Set"],["ShallowReactive",3242],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fbMCbwbpo1gMf6ZhuKs_Y0NohUovL2C5Ml942sXVlR8E":-1},"/vuejs/vitepress/2684"]