\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.6626153,{"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\nI'm trying to piece together how to properly create\r\n```html\r\n\u003Cmeta property=\"og:image\" content=\"https://my.page/images/example.png\">\r\n```\r\nand similar.\r\n\r\nI found\r\n- https://github.com/vuejs/vitepress/issues/504 which just points out links need to be absolute\r\n- https://github.com/vuejs/vitepress/issues/551 where a bunch of questions are asked and then just the transformHead API is linked\r\n- the docs for https://vitepress.dev/reference/site-config#transformhead.\r\n\r\nI tried to reference the image from frontmatter;\r\nbut while the direct markdown image reference is resolved and copied out, the frontmatter URL stays the same.\r\n\r\n```yaml\r\n---\r\ntitle: \"Title\"\r\ndescription: \"Desc\"\r\nhead:\r\n - - meta\r\n - name: property=\"og:image\"\r\n content: ./../src/relative/image.jpg\r\n---\r\n\r\n\r\n```\r\n\r\nThe above _should_ in my opinion result in the image being copied over and the path resolved, and then the path could be further transformed in transformHead given some known absolute target URL where the website will end up at.\r\n\r\nI also tried\r\n`content: url(./../src/relative/image.jpg)`\r\nin the hopes that this will trigger vite/vitepress understanding that's a file/url and should be treated as such, but that didn't work either.\r\n\r\n### Reproduction\r\n\r\nIt seems I can't upload images at vitepress.new, so can't add a repro there. I hope above explanation is sufficient.\r\n\r\n### Expected behavior\r\n\r\n1. Ability to reference relative images from frontmatter so they're bundled properly\r\n2. Docs for how to transform them to absolute URLs for use as meta tags\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem:\r\n OS: Windows 10 10.0.22621\r\n CPU: (12) x64 Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz\r\n Memory: 32.63 GB / 63.85 GB\r\n Binaries:\r\n Node: 18.13.0 - D:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.13.2 - D:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 113.0.5672.127\r\n Edge: Spartan (44.22621.1702.0), Chromium (113.0.1774.35)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-beta.1 => 1.0.0-beta.1\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nThere could also be additional processing steps involved on images (e.g. vite imagetools), so I think images referenced from frontmatter should be bundled/processed too.\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",2419,"Frontmatter: images in meta tags aren't resolved/bundled","2023-08-03T10:15:36Z","https://github.com/vuejs/vitepress/issues/2419",0.68999296,{"description":3169,"labels":3170,"number":3172,"owner":3149,"repository":3150,"state":3173,"title":3174,"updated_at":3175,"url":3176,"score":3177},"\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",[3171],{"name":3146,"color":3147},113,"closed","Local images stripped out in build","2023-01-21T16:24:20Z","https://github.com/vuejs/vitepress/issues/113",0.654438,{"description":3179,"labels":3180,"number":3182,"owner":3149,"repository":3150,"state":3173,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### Describe the bug\n\nall auto import components in dev mode is ok.\nall auto import components in build mode is ok, when there have no 'script' tag in md files\n\nif md file have 'script' tag of one page. the page's auto import component will not resolve in **build mode**!!!!\n\n### Reproduction\n\nit's an empty vitepress project.\n\n[Reproduction URL](https://github.com/huchaomin/vitepress-auto-import-bug)\n\n### Expected behavior\n\n\u003Cimg width=\"900\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/76a803ce-949b-4ae2-b229-32484d930cde\" />\n\n\u003Cimg width=\"821\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/d4b60aea-4b7c-422f-8c0e-339be12dbe42\" />\n\n\u003Cimg width=\"901\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/691bb9b3-a61d-4f15-8426-68416f7340da\" />\n\n\u003Cimg width=\"915\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/9c8470cc-7c45-476a-aaf1-3f990a1c57f0\" />\n\n### System Info\n\n```Text\nSystem:\n OS: Windows 11 10.0.22631\n CPU: (28) x64 Intel(R) Core(TM) i7-14700KF\n Memory: 15.99 GB / 31.82 GB\n Binaries:\n Node: 20.17.0 - D:\\Program Files\\nodejs\\node.EXE\n npm: 10.8.2 - D:\\Program Files\\nodejs\\npm.CMD\n pnpm: 9.8.0 - D:\\Program Files\\nodejs\\pnpm.CMD\n Browsers:\n Edge: Chromium (127.0.2651.74)\n Internet Explorer: 11.0.22621.3527\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.",[3181],{"name":3146,"color":3147},4519,"\"vitepress\" work with \"unplugin-vue-components\" bug","2025-02-02T04:41:47Z","https://github.com/vuejs/vitepress/issues/4519",0.66259956,{"description":3188,"labels":3189,"number":3190,"owner":3149,"repository":3150,"state":3173,"title":3191,"updated_at":3192,"url":3193,"score":3194},"### Describe the bug\n\n\r\n\r\n\n\n### Reproduction\n\n引入外部资源\n\n### Expected behavior\n\n起作用\n\n### System Info\n\n```shell\n...\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.",[],667,"md 文件引入vue失败","2023-01-21T14:35:40Z","https://github.com/vuejs/vitepress/issues/667",0.6666071,{"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\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.",[3198],{"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.6667609,{"description":3205,"labels":3206,"number":3210,"owner":3149,"repository":3150,"state":3173,"title":3211,"updated_at":3212,"url":3213,"score":3214},"### 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.",[3207],{"name":3208,"color":3209},"duplicate","cfd3d7",434,"This is a suggestion","2023-01-21T16:04:15Z","https://github.com/vuejs/vitepress/issues/434",0.6741971,{"description":3216,"labels":3217,"number":3219,"owner":3149,"repository":3150,"state":3173,"title":3220,"updated_at":3221,"url":3222,"score":3223},"\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\nIn the markdown file, When reference a image file with encoded URL, it works in the dev mode, but it would faild to build.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\n1. a image file named `image (01).png`.\r\n1. a markdown file with content like this: ``\r\n1. run `vitepress build`\r\n\r\n**Expected behavior**\r\nShould build successfully.\r\n\r\n**System Info**\r\n- vitepress version: 0.11.5\r\n- vite version: 2.0.0-beta.62\r\n- Node version: 2.0.0-beta.62\r\n- OS version: Windows 10\r\n",[3218],{"name":3208,"color":3209},220,"can not handle encoded image URLs in build mode","2023-01-21T16:23:56Z","https://github.com/vuejs/vitepress/issues/220",0.67578447,{"description":3225,"labels":3226,"number":3228,"owner":3149,"repository":3150,"state":3173,"title":3229,"updated_at":3230,"url":3231,"score":3232},"### 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.",[3227],{"name":3146,"color":3147},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.67658013,{"description":3234,"labels":3235,"number":3237,"owner":3149,"repository":3150,"state":3173,"title":3238,"updated_at":3239,"url":3240,"score":3241},"### Describe the bug\n\nWhen I want to import, I find that it will report an error.\r\n\r\nI see that the document is imported in this way.\r\n\r\nIs there anything wrong?Why doesn't it happen when I import from vue?\r\n\r\n\r\n\n\n### Reproduction\n\nAfter I created the project based on the document, I only installed 'vitepress-theme-demoblock'.\r\nThese are my configurations:\r\n\r\n\r\nAnd then it happended.\n\n### Expected behavior\n\nI was about to import some custom objects in the demo, but I found that even useData cannot be imported.\n\n### System Info\n\n```shell\n[vitepress] Internal server error: Transform failed with 1 error:\r\nE:/Draculabo/min-vitepress/vitepress-starter/docs/components/test.md:22:7: ERROR: Unexpected \"{\"\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.",[3236],{"name":3146,"color":3147},1990,"Internal server error: Import error in the demo container.","2023-03-17T00:04:20Z","https://github.com/vuejs/vitepress/issues/1990",0.6787692,["Reactive",3243],{},["Set"],["ShallowReactive",3246],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$f_xKDhW8lcxfF12alPooz7EB6zO0pVdO0TLjoeVutB70":-1},"/vuejs/vitepress/2357"]