\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.",[3151,3154,3157],{"name":3152,"color":3153},"build","377ba8",{"name":3155,"color":3156},"has-workaround","1B4515",{"name":3158,"color":3159},"stale","ededed",4045,"vuejs","vitepress","open","SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.6909657,{"description":3169,"labels":3170,"number":3174,"owner":3161,"repository":3162,"state":3163,"title":3175,"updated_at":3176,"url":3177,"score":3178},"### Describe the bug\n\nThe arrow icons in the navigation bar frequently trigger redrawing\n\n### Reproduction\n\n[class^='vpi-']:not(.bg), [class*=' vpi-']:not(.bg), .vp-icon:not(.bg) {\n /* -webkit-mask: var(--icon) no-repeat; */\n mask: var(--icon) no-repeat;\n -webkit-mask-size: 100% 100%;\n mask-size: 100% 100%;\n background-color: currentColor;\n color: inherit;\n\n\n\u003Cimg width=\"877\" height=\"564\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/a7824fe4-ce4a-4553-828c-3a7b6f623ab4\" />\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.",[3171],{"name":3172,"color":3173},"bug: pending triage","e99695",4917,"Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.69752836,{"description":3180,"labels":3181,"number":3183,"owner":3161,"repository":3162,"state":3184,"title":3185,"updated_at":3186,"url":3187,"score":3188},"### 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.",[3182],{"name":3172,"color":3173},362,"closed","Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.7009233,{"description":3190,"labels":3191,"number":3195,"owner":3161,"repository":3162,"state":3184,"title":3196,"updated_at":3197,"url":3198,"score":3199},"### Describe the bug\n\nWhen using \r\n```\r\nthemeConfig: {\r\n\t\tlogo: '/logo-Wikimedia.svg'\r\n}\r\n```\r\nthe `img` output doesn't feature an `alt` attribute required for screenreaders. \r\nEither a duplication of the title or better a required `logoAlt` key would be useful.\n\n### Reproduction\n\nGo to https://doc.wikimedia.org/codex/main/ and inspect the source:\r\n`\u003Cimg class=\"VPImage logo\" src=\"/codex/main/logo-Wikimedia.svg\" data-v-d5fed348=\"\">`\n\n### Expected behavior\n\n`img` tags need to feature an `alt` attribute to be valid HTML. Starting with an empty one and providing an option to define the value would be necessary.\n\n### System Info\n\n```shell\nVitePress 1.0.0-alpha.10\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.",[3192],{"name":3193,"color":3194},"docs","0075ca",1309,"themeConfig logo option results in an `img` output without `alt` attribute","2023-01-21T14:25:29Z","https://github.com/vuejs/vitepress/issues/1309",0.7027753,{"description":3201,"labels":3202,"number":3203,"owner":3161,"repository":3162,"state":3184,"title":3204,"updated_at":3205,"url":3206,"score":3207},"### Describe the bug\n\n在我编写一个.md文件时我是这么写的:\r\n\r\n```\r\n\u003Cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/NoNameGMM/SignInForMiraiMC?style=flat&label=License\r\n\"/>\r\n\u003Cimg alt=\"Minecraft Version\" src=\"https://img.shields.io/badge/Minecraft-1.8--1.20-blue?style=flat&color=green\"/>\r\n\u003Cimg alt=\"GitHub Release\" src=\"https://img.shields.io/github/v/release/NoNameGMM/SignInForMiraiMC?style=flat&label=Release\"/>\r\n```\r\n\r\n正常来说应该是这样:\r\n\u003Cimg width=\"249\" alt=\"photo1\" src=\"https://github.com/vuejs/vitepress/assets/109721871/d5c41be5-f3df-43f7-bd88-a2f12a11490f\">\r\n\r\n可是vitepress的效果是:\r\n\u003Cimg width=\"107\" alt=\"屏幕截图 2024-03-03 200157\" src=\"https://github.com/vuejs/vitepress/assets/109721871/a5b20517-2e3f-4fb0-9390-1f06cdbbebd6\">\r\n\r\n\r\n\n\n### Reproduction\n\n同上\n\n### Expected behavior\n\n我想要实现正常markdown的效果\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (16) x64 AMD Ryzen 7 5800H with Radeon Graphics\r\n Memory: 1.68 GB / 13.86 GB\r\n Binaries:\r\n Node: 20.10.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 10.2.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.15.4 - ~\\AppData\\Roaming\\npm\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (122.0.2365.59)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.44 => 1.0.0-rc.44\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.",[],3631,"使用shields.io徽标时图片自动换行","2024-03-11T00:04:39Z","https://github.com/vuejs/vitepress/issues/3631",0.70600855,{"description":3209,"labels":3210,"number":3212,"owner":3161,"repository":3162,"state":3184,"title":3213,"updated_at":3214,"url":3215,"score":3216},"### 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.",[3211],{"name":3172,"color":3173},4238,"Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.706845,{"description":3218,"labels":3219,"number":3221,"owner":3161,"repository":3162,"state":3184,"title":3222,"updated_at":3223,"url":3224,"score":3225},"### Describe the bug\r\n\r\nhttps://github.com/vuejs/vitepress/blob/75ca9e4302c65e3bcc9518f7df928318380f6cf6/src/node/markdown/plugins/highlightLines.ts#L30\r\n\r\n`highlightLinePlugin` is used before `attrs`, and `token.info` is rewritten.\r\n\r\nvia https://github.com/vuejs/vitepress/pull/664#discussion_r902203459\r\n\r\n### Reproduction\r\n\r\n\u003Cimg width=\"177\" alt=\"image\" src=\"https://user-images.githubusercontent.com/8336744/174726207-1c068f94-f597-4d5e-9101-4709a08a60c3.png\">\r\n\r\n\u003Cimg width=\"299\" alt=\"image\" src=\"https://user-images.githubusercontent.com/8336744/174726233-83967c42-db47-4c12-8dbd-0c83a817c448.png\">\r\n\r\n\r\n### Expected behavior\r\n\r\nRender `data=\"asdf\"`\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.0\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 13.84 GB / 64.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.1 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/node\r\n Yarn: 1.22.19 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/yarn\r\n npm: 8.12.1 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/npm\r\n Browsers:\r\n Chrome: 102.0.5005.115\r\n Firefox: 101.0.1\r\n Safari: 16.0\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.2 => 1.0.0-alpha.2\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/about/coc.html)\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.",[3220],{"name":3158,"color":3159},826,"support adding attributes to code blocks","2023-08-11T00:04:28Z","https://github.com/vuejs/vitepress/issues/826",0.7069205,{"description":3227,"labels":3228,"number":3230,"owner":3161,"repository":3162,"state":3184,"title":3231,"updated_at":3232,"url":3233,"score":3234},"### Describe the bug\n\nCheck VP types here https://arethetypeswrong.github.io/?p=vitepress%401.0.0-beta.1, `vitepress/theme-without-fonts` types for node missing.\r\n\n\n### Reproduction\n\nhttps://arethetypeswrong.github.io/?p=vitepress%401.0.0-beta.1\n\n### Expected behavior\n\nTypes should be there\n\n### System Info\n\n```sh\nNA\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":3172,"color":3173},2415,"missing vitepress/theme-without-fonts types for node","2023-06-02T00:04:15Z","https://github.com/vuejs/vitepress/issues/2415",0.7101737,{"description":3236,"labels":3237,"number":3238,"owner":3161,"repository":3162,"state":3184,"title":3239,"updated_at":3240,"url":3241,"score":3242},"### Describe the bug\n\nUsing the features list for home page generates VPLink as VPFeature, which is an \u003Ca> tag without a href.\r\n\r\nThis causes SEO issues\r\n\r\n\r\n\n\n### Reproduction\n\nUse features list at home page\n\n### Expected behavior\n\nAn entire div should not be an \u003Ca> tag if it's not supposed to link anywhere\n\n### System Info\n\n```sh\nSystem:\r\n OS: Windows 10 10.0.23506\r\n CPU: (16) x64 AMD Ryzen 7 7800X3D 8-Core Processor\r\n Memory: 11.73 GB / 31.73 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.23506.1000.0), Chromium (116.0.1938.29)\r\n Internet Explorer: 11.0.23506.1000\r\n npmPackages:\r\n vitepress: ^1.0.0-beta.6 => 1.0.0-beta.6\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.",[],2684,"VPFeatures using VPLink","2023-08-03T00:04:16Z","https://github.com/vuejs/vitepress/issues/2684",0.7110794,{"description":3244,"labels":3245,"number":3247,"owner":3161,"repository":3162,"state":3184,"title":3248,"updated_at":3249,"url":3250,"score":3251},"### 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.",[3246],{"name":3172,"color":3173},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.7168246,["Reactive",3253],{},["Set"],["ShallowReactive",3256],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fHH8wUYW2n2pFLl3pmojwwm5BZV8Mj_0i62pOTNx0QUo":-1},"/vuejs/vitepress/4854"]