\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.6983397,{"description":3157,"labels":3158,"number":3160,"owner":3149,"repository":3150,"state":3151,"title":3161,"updated_at":3162,"url":3163,"score":3164},"### Describe the bug\n\nI have found VitePress and it seems to be great fit to our needs.\n\nHowever:\n- official site https://vitepress.dev offers only docs for v2.0.0-alpha.12 (the pop down shows only links to Changelog and Contributing)\n- I was unable to find any site for stable version (currently v1.6.4)\n\nI had to clone the repo and build the docs for v1.6.4 myself.\n\nIs building docs for stable version of VitePress expected way, users access the docs?\n\nOr are users already supposed to use the v2.0.0 alpha version?\n\n\n\n### Reproduction\n\nTry to find VitePress documentation for latest stable version (currently v1.6.4)\n\nThe only one published is for v2.0.0-alpha.12\n\n### Expected behavior\n\nFind somewhere:\n- on a public URL\n- or at least as downloadable artefact\ndocumentation for v1.6.4 (or other latest stable version).\n\n\n### System Info\n\n```Text\nnot relevant\n```\n\n### Additional context\n\nThe Validation check for this issue is advising me to use \"the latest VitePress version\" leading to v2.0.0-alpha.12 \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":3146,"color":3147},4945,"Missing VitePress documentation for stable version (v1.6.4 currently)","2025-09-14T20:32:53Z","https://github.com/vuejs/vitepress/issues/4945",0.70248806,{"description":3166,"labels":3167,"number":3172,"owner":3149,"repository":3150,"state":3151,"title":3173,"updated_at":3174,"url":3175,"score":3176},"### 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.",[3168,3169],{"name":3146,"color":3147},{"name":3170,"color":3171},"stale","ededed",4200,"动态路由打包后遇到的bug,开发环境正常","2024-10-26T17:17:22Z","https://github.com/vuejs/vitepress/issues/4200",0.70284146,{"description":3178,"labels":3179,"number":3181,"owner":3149,"repository":3150,"state":3182,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### 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.",[3180],{"name":3146,"color":3147},362,"closed","Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.6565451,{"description":3188,"labels":3189,"number":3191,"owner":3149,"repository":3150,"state":3182,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### 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.",[3190],{"name":3146,"color":3147},2349,"热更新","2023-05-24T00:03:54Z","https://github.com/vuejs/vitepress/issues/2349",0.6812195,{"description":3197,"labels":3198,"number":3201,"owner":3149,"repository":3150,"state":3182,"title":3202,"updated_at":3203,"url":3204,"score":3205},"### 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.",[3199,3200],{"name":3146,"color":3147},{"name":3170,"color":3171},2385,"Vitepress build Problem","2023-08-18T00:04:08Z","https://github.com/vuejs/vitepress/issues/2385",0.68303645,{"description":3207,"labels":3208,"number":3212,"owner":3149,"repository":3150,"state":3182,"title":3213,"updated_at":3214,"url":3215,"score":3216},"\u003C!--\r\nNOTE:\r\nVitePress is still WIP, and it is not compatible with VuePress.\r\nPlease do not open issue about default theme missing features or something doesn't work like VuePress.\r\n-->\r\n\r\n**Describe the bug**\r\n\r\nthere are two url link`/frontend/javaScript`&`/frontend/javaScriptDesign`,when i choose `/frontend/javaScriptDesign`,the `/frontend/javaScript` item is actived too\r\n\r\n\r\n\r\n**Expected behavior**\r\nA clear and concise description of what you expected to happen.\r\n\r\n**System Info**\r\n- vitepress version: 0.12.2\r\n- vite version:\r\n- Node version: 14.15.4\r\n- OS version: macos 11.2.1 (20D74)\r\n\r\n**Additional context**\r\n\r\n```js\r\n{\r\n text: \"前端\",\r\n items: [\r\n\t {text: 'js', link: '/frontend/javaScript'},\r\n\t {text: 'js设计模式', link: '/frontend/javaScriptDesign'},\r\n\t {text: '兼容性', link: '/frontend/compatible'},\r\n\t {text: '框架', link: '/frontend/frame'},\r\n\t {text: '性能', link: '/frontend/performance'},\r\n\t {text: '视频', link: '/frontend/video'},\r\n\t {text: 'css', link: '/frontend/css'},\r\n\t {text: '浏览器', link: '/frontend/browser'},\r\n ]\r\n}\r\n```",[3209],{"name":3210,"color":3211},"need more info","bdbefc",259,"nav actived item error","2023-01-21T14:28:32Z","https://github.com/vuejs/vitepress/issues/259",0.6841209,{"description":3218,"labels":3219,"number":3220,"owner":3149,"repository":3150,"state":3182,"title":3221,"updated_at":3222,"url":3223,"score":3224},"\u003C!--\r\nNOTE:\r\nVitePress is still WIP, and it is not compatible with VuePress.\r\nPlease do not open issue about default theme missing features or something doesn't work like VuePress.\r\n-->\r\n\r\n**Describe the bug**\r\nCyrillic \"л\" is replaced by Latin \"n\" in the anchor links.\r\n\r\n**To Reproduce**\r\n- `git clone https://github.com/stereshko/tailwind-jit-vitepress.git`\r\n- `yarn install`\r\n- `yarn docs:dev`\r\n- visit `localhost:3000`\r\n- check anchor links\r\n\r\n**Expected behavior**\r\nAnchor links `#загоnовок` => `#заголовок`, `#подзагоnовок` => `#подзаголовок`, `#лn` => `#лл`,\r\n\r\n**System Info**\r\n- vitepress version: 0.13.2\r\n- vite version: 2.2.4\r\n- Node version: 14.16.1\r\n- OS version: Windows 10 Pro 20H2\r\n",[],299,"Problems with cyrillic symbol in the anchor links","2023-01-21T16:04:17Z","https://github.com/vuejs/vitepress/issues/299",0.68497586,{"description":3226,"labels":3227,"number":3229,"owner":3149,"repository":3150,"state":3182,"title":3230,"updated_at":3231,"url":3232,"score":3233},"### Describe the bug\n\n\u003Cimg width=\"269\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/10622fbc-efb0-4dbd-a342-5c4e73ed04a0\">\r\n\u003Cimg width=\"1272\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/42577ef3-634d-459e-bf05-97ada3afef7b\">\r\n以前旧版本是没有这个问题的。升级后才有的。\n\n### Reproduction\n\n升级vitepress打包部署后出现的\n\n### Expected behavior\n\n望能修复正常\n\n### System Info\n\n```sh\nSystem:\r\n OS: macOS 13.4.1\r\n CPU: (8) arm64 Apple M1\r\n Memory: 57.69 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 16.14.0 - ~/.nvm/versions/node/v16.14.0/bin/node\r\n Yarn: 1.22.19 - ~/.nvm/versions/node/v16.14.0/bin/yarn\r\n npm: 9.8.0 - ~/.nvm/versions/node/v16.14.0/bin/npm\r\n Watchman: 2023.03.27.00 - /opt/homebrew/bin/watchman\r\n Browsers:\r\n Chrome: 115.0.5790.170\r\n Safari: 16.5.2\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.",[3228],{"name":3146,"color":3147},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.68723094,{"description":3235,"labels":3236,"number":3238,"owner":3149,"repository":3150,"state":3182,"title":3239,"updated_at":3240,"url":3241,"score":3242},"### Describe the bug\n\nI added team component feedback error in index.md\r\n\r\n\n\n### Reproduction\n\n---\r\nlayout: home\r\n\r\nhero:\r\n name: VitePress\r\n text: Vite & Vue powered static site generator.\r\n tagline: Simple, powerful, and performant. Meet the modern SSG framework you've always wanted.\r\n actions:\r\n - theme: brand\r\n text: Get Started\r\n link: /example\r\n - theme: alt\r\n text: View on GitHub\r\n link: https://github.com/vuejs/vitepress\r\n---\r\n\r\n\u003Cscript setup>\r\nimport { VPTeamMembers } from 'vitepress/theme'\r\n\r\nconst members = [\r\n {\r\n avatar: 'https://www.github.com/yyx990803.png',\r\n name: 'Evan You',\r\n title: 'Creator',\r\n links: [\r\n { icon: 'github', link: 'https://github.com/yyx990803' },\r\n { icon: 'twitter', link: 'https://twitter.com/youyuxi' }\r\n ]\r\n },\r\n ...\r\n]\r\n\u003C/script>\r\n\r\n# Our Team\r\n\r\nSay hello to our awesome team.\r\n\r\n\u003CVPTeamMembers size=\"small\" :members=\"members\" />\r\n\n\n### Expected behavior\n\nnormal\n\n### System Info\n\n```Text\nSystem:\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: 18.20.3 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 10.2.3 - /usr/local/bin/npm\r\n pnpm: 8.15.6 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: latest => 1.3.4\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.",[3237],{"name":3146,"color":3147},4238,"Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.6927226,["Reactive",3244],{},["Set"],["ShallowReactive",3247],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fUm8M_5ZGFfLrP2qQ3hIkMZ1cc4UEtQJadrEVfkdLfF0":-1},"/vuejs/vitepress/4463"]