\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.",[3151],{"name":3152,"color":3153},"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.6738537,{"description":3163,"labels":3164,"number":3174,"owner":3155,"repository":3156,"state":3157,"title":3175,"updated_at":3176,"url":3177,"score":3178},"### Describe the bug\r\n\r\nUsage:\r\n```yaml\r\nfeatures:\r\n - icon: \u003Ci class=\"i-carbon-sun\" />\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.",[3165,3168,3171],{"name":3166,"color":3167},"build","377ba8",{"name":3169,"color":3170},"has-workaround","1B4515",{"name":3172,"color":3173},"stale","ededed",4045,"SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.6977659,{"description":3180,"labels":3181,"number":3183,"owner":3155,"repository":3156,"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":3152,"color":3153},362,"closed","Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.66128254,{"description":3190,"labels":3191,"number":3195,"owner":3155,"repository":3156,"state":3184,"title":3196,"updated_at":3197,"url":3198,"score":3199},"### Describe the bug\n\n1. 组件中 style scoped 使用了 bootstrap,某些 class 样式出不来,比如下面 `rounded`;\r\n\r\n\r\n2. 如果在 vue 组件的 script 导入 bootstrap,则会影响默认主题的样式,比如下面标题\r\n\r\n\r\n3. 不管是使用 slots 还是使用全局注册组件,都是一样的问题;\n\n### Reproduction\n\n默认主题结合 bootstrap 很容易重现。\n\n### Expected behavior\n\n我希望在 vitepress 的组件中使用 bootstrap 快速开发。\n\n### System Info\n\n```sh\nSystem:\r\n OS: Linux 5.15 Ubuntu 22.04.1 LTS 22.04.1 LTS (Jammy Jellyfish)\r\n CPU: (8) x64 Intel(R) Core(TM) i7-8650U CPU @ 1.90GHz\r\n Memory: 4.30 GB / 7.72 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 19.5.0 - ~/.nvm/versions/node/v19.5.0/bin/node\r\n npm: 9.6.4 - ~/.nvm/versions/node/v19.5.0/bin/npm\r\n pnpm: 8.6.9 - ~/.local/share/pnpm/pnpm\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.",[3192],{"name":3193,"color":3194},"theme","0754FB",2683,"默认主题添加组件使用 bootstrap 样式没有预期","2023-08-18T00:04:15Z","https://github.com/vuejs/vitepress/issues/2683",0.67280424,{"description":3201,"labels":3202,"number":3204,"owner":3155,"repository":3156,"state":3184,"title":3205,"updated_at":3206,"url":3207,"score":3208},"### 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.",[3203],{"name":3152,"color":3153},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.6773879,{"description":3210,"labels":3211,"number":3212,"owner":3155,"repository":3156,"state":3184,"title":3213,"updated_at":3214,"url":3215,"score":3216},"### 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.6834861,{"description":3218,"labels":3219,"number":3221,"owner":3155,"repository":3156,"state":3184,"title":3222,"updated_at":3223,"url":3224,"score":3225},"### Describe the bug\n\nhttps://flowbite-vue.com/pages/getting-started\n\n\u003Cimg width=\"97\" height=\"103\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/eb9f85c1-6df8-47e9-950a-8b1aeb92b7ba\" />\n\n\n```vue\n\u003Cscript setup>\nimport { FwbButton } from 'flowbite-vue'\n\u003C/script>\n\u003Ctemplate>\n \u003Cdiv>\n \u003Cfwb-button color=\"default\">Default\u003C/fwb-button>\n \u003C/div>\n\u003C/template>\n```\n\n### Reproduction\n\nhttps://github.com/jk2K/testvitepress\n\ntech stack\n1. https://flowbite-vue.com/pages/getting-started\n2. tailwindcss v4\n\n### Expected behavior\n\n\u003Cimg width=\"103\" height=\"50\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7bffdf53-2faf-4257-87c2-4f60511b7060\" />\n\n### System Info\n\n```Text\nSystem:\n OS: macOS 15.5\n CPU: (14) arm64 Apple M4 Pro\n Memory: 218.33 MB / 48.00 GB\n Shell: 5.9 - /bin/zsh\n Binaries:\n Node: 22.16.0 - ~/.nvm/versions/node/v22.16.0/bin/node\n npm: 10.9.2 - ~/.nvm/versions/node/v22.16.0/bin/npm\n pnpm: 10.11.0 - /opt/homebrew/bin/pnpm\n Browsers:\n Chrome: 138.0.7204.159\n Safari: 18.5\n npmPackages:\n vitepress: ^1.6.3 => 1.6.3\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.",[3220],{"name":3152,"color":3153},4856,"vitepress not work for flowbite-vue","2025-07-25T10:13:26Z","https://github.com/vuejs/vitepress/issues/4856",0.68409085,{"description":3227,"labels":3228,"number":3230,"owner":3155,"repository":3156,"state":3184,"title":3231,"updated_at":3232,"url":3233,"score":3234},"\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\nCan't use `img` tag in `v0.7.1` (works in `v0.7.0`).\r\n\r\n**To Reproduce**\r\n\r\n1.\r\n```sh\r\nnpm init\r\nyarn add vitepress\r\nwget -O vue.png https://upload.wikimedia.org/wikipedia/commons/thumb/9/95/Vue.js_Logo_2.svg/220px-Vue.js_Logo_2.svg.png\r\necho '' > index.md\r\n```\r\n\r\n2. `npx vitepress` – image will work in development\r\n\r\n\r\n3. `npx vitepress build`\r\n* build will fail due to https://github.com/vitejs/vite/pull/992\r\n* but even with that fix, the build will strip out `src` attribute of `img` and no image will be loaded\r\n\r\n**Expected behavior**\r\nImages should be preserved in build.\r\n\r\n**System Info**\r\n- vitepress version: 0.7.1\r\n- vite version: 1.0.0-rc.8\r\n- Node version: 15.0.1\r\n- OS version: macOS 10.16.7\r\n\r\n**Additional context**\r\n\r\nUsing an absolute URL works as expected in dev and build.\r\n",[3229],{"name":3152,"color":3153},113,"Local images stripped out in build","2023-01-21T16:24:20Z","https://github.com/vuejs/vitepress/issues/113",0.68488914,{"description":3236,"labels":3237,"number":3241,"owner":3155,"repository":3156,"state":3184,"title":3242,"updated_at":3243,"url":3244,"score":3245},"### Is your feature request related to a problem? Please describe.\r\n\r\nWhen I use Element-Plus in VitePress, the partial style of the component is modified. The reason is VitePress `src/client/theme-default/styles/layout.css` File reset all styles.\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Describe the solution you'd like\r\n\r\nI hope this code only takes effect in VitePress.\r\n\r\n### Describe alternatives you've considered\r\n\r\n_No response_\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/master/.github/contributing.md).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3238],{"name":3239,"color":3240},"duplicate","cfd3d7",434,"This is a suggestion","2023-01-21T16:04:15Z","https://github.com/vuejs/vitepress/issues/434",0.6863902,{"description":3247,"labels":3248,"number":3250,"owner":3155,"repository":3156,"state":3184,"title":3251,"updated_at":3252,"url":3253,"score":3254},"### Describe the bug\n\nexternalLinkIcon as true doesn't add the icon.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-ysfhai?file=docs%2F.vitepress%2Fconfig.ts\n\n### Expected behavior\n\nicon should be shown\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22621\r\n CPU: (4) x64 Intel(R) Core(TM) i5 CPU M 520 @ 2.40GHz\r\n Memory: 2.15 GB / 7.93 GB\r\n Binaries:\r\n Node: 20.10.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 10.2.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.121)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.35 => 1.0.0-rc.35\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.",[3249],{"name":3152,"color":3153},3424,"externalLinkIcon isn't working","2024-01-16T00:04:36Z","https://github.com/vuejs/vitepress/issues/3424",0.6866214,["Reactive",3256],{},["Set"],["ShallowReactive",3259],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$f2ascQS94IabdIwQ8KzomA1bkWiajqXlHm4tOY1MvtaU":-1},"/vuejs/vitepress/3397"]