\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.7184042,{"description":3163,"labels":3164,"number":3166,"owner":3155,"repository":3156,"state":3167,"title":3168,"updated_at":3169,"url":3170,"score":3171},"### Describe the bug\n\nIn dev mode, both image filenames contain space or not will serve fine:\r\n\r\n\u003Cimg width=\"1282\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/3367820/acc1113c-6f46-4f0f-abd2-b3a0936792a9\">\r\n\r\n\r\nBut the build will fail when met the image assets whose filename contains space:\r\n\r\n\u003Cimg width=\"1202\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/3367820/329c0a68-86f5-4239-abfb-4335227e6de6\">\r\n\n\n### Reproduction\n\nSee https://stackblitz.com/edit/vite-upxxuh?file=docs%2Fbook%2Fresources%2Ftest%20(1).svg,docs%2Findex.md,docs%2Fbook%2Fresources%2Ftest.svg,\r\n\r\nadd a image filename contains space and build.\n\n### Expected behavior\n\nBuild should succeed.\r\n\r\nIdeally should `decodeURIComponent` when converting `.png]` to code. \r\n\r\nSo the converted code should be like `import image from \"image (1).png\"` instead of `import image from \"image%20(1).png\"`.\n\n### System Info\n\n```sh\n❯ npx envinfo --system --npmPackages vitepress --binaries --browsers\r\n\r\n\r\nNeed to install the following packages:\r\n envinfo@7.10.0\r\nOk to proceed? (y) y\r\n\r\n System:\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: 16.20.0 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 9.4.2 - /usr/local/bin/npm\r\n pnpm: 8.6.3 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: v1.0.0-beta.5 => 1.0.0-beta.5\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.",[3165],{"name":3152,"color":3153},2596,"closed","Included image filename contains space will make build fail","2023-07-17T00:04:57Z","https://github.com/vuejs/vitepress/issues/2596",0.64317024,{"description":3173,"labels":3174,"number":3176,"owner":3155,"repository":3156,"state":3167,"title":3177,"updated_at":3178,"url":3179,"score":3180},"### Describe the bug\n\nimage not display at previewing, but replace with base64 string, it is ok !\r\n\r\n\n\n### Reproduction\n\n1. use `layout:home` in the index page\r\n2. configure the Hero section\r\n3. run `npm run docs:build` then `npm run docs:docs:preview` \r\n4. to preview the website\n\n### Expected behavior\n\ncan display the image by file path\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 11th Gen Intel(R) Core(TM) i5-11400F @ 2.60GHz\r\n Memory: 8.52 GB / 15.87 GB\r\n Binaries:\r\n Node: 16.13.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 8.1.2 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.57)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.48 => 1.0.0-alpha.48\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.",[3175],{"name":3152,"color":3153},2013,"image not display at previewing","2023-03-09T00:04:38Z","https://github.com/vuejs/vitepress/issues/2013",0.69155335,{"description":3182,"labels":3183,"number":3196,"owner":3155,"repository":3156,"state":3167,"title":3197,"updated_at":3198,"url":3199,"score":3200},"### Describe the bug\n\n当xxx.md中引用了图片,而图片的名字中含有空格则build失败\r\n如图:\r\n\u003Cimg width=\"791\" alt=\"WX20220308-210322@2x\" src=\"https://user-images.githubusercontent.com/85027237/157245257-cb9faa7b-edef-4c3d-9afa-a86068e89ad6.png\">\r\n\r\n图片名字如下:\r\n`Screenshot 2021-07-05 at 12.53.29.png`\r\n\r\n在xxx.md中去掉相关以下内容 build 成功。\r\n``\n\n### Reproduction\n\nyarn build:docs\n\n### Expected behavior\n\n希望有空可以优化下。\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.0.1\r\n CPU: (4) x64 Intel(R) Core(TM) i5-5257U CPU @ 2.70GHz\r\n Memory: 16.57 MB / 8.00 GB\r\n Shell: 3.2.57 - /bin/bash\r\n Binaries:\r\n Node: 16.13.1 - /usr/local/bin/node\r\n Yarn: 1.5.1 - /usr/local/bin/yarn\r\n npm: 8.1.2 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 93.0.4577.82\r\n Edge: 99.0.1150.36\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.",[3184,3187,3190,3193],{"name":3185,"color":3186},"build","377ba8",{"name":3188,"color":3189},"has-workaround","1B4515",{"name":3191,"color":3192},"upstream","BF29ED",{"name":3194,"color":3195},"stale","ededed",573,"unable to use assets or markdown files with space in name","2023-10-28T00:04:00Z","https://github.com/vuejs/vitepress/issues/573",0.7015622,{"description":3202,"labels":3203,"number":3205,"owner":3155,"repository":3156,"state":3167,"title":3206,"updated_at":3207,"url":3208,"score":3209},"### Describe the bug\n\nwhen I use a .png in xx.md file, it is OK, when i use a .PNG, get error.\r\n\r\n\r\nThis issue only occurs when using the `docs:build` command, it is fine in `docs:dev`\n\n### Reproduction\n\n vitepress v1.0.0-alpha.73\r\n\r\nWindows 11\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.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3204],{"name":3152,"color":3153},2277,"Bugs caused by image suffix capitalization","2023-05-01T00:04:42Z","https://github.com/vuejs/vitepress/issues/2277",0.705594,{"description":3211,"labels":3212,"number":3214,"owner":3155,"repository":3156,"state":3167,"title":3215,"updated_at":3216,"url":3217,"score":3218},"### 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.",[3213],{"name":3152,"color":3153},1781,"在内容里使用 {xxx} 就会报错","2023-01-21T14:16:43Z","https://github.com/vuejs/vitepress/issues/1781",0.70590585,{"description":3220,"labels":3221,"number":3223,"owner":3155,"repository":3156,"state":3167,"title":3224,"updated_at":3225,"url":3226,"score":3227},"### 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.",[3222],{"name":3152,"color":3153},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.7079735,{"description":3229,"labels":3230,"number":3232,"owner":3155,"repository":3156,"state":3167,"title":3233,"updated_at":3234,"url":3235,"score":3236},"### Describe the bug\n\nimage embed markdown not rendering as a image insted it is rendered as a plain text when link (of media/image) have spaces.\r\n`` - renders as plain text\r\n`` - renders as normal image\r\n\r\n\u003Cbr>\r\n\r\n**why can't i use \"-\" or \"_\"?**\r\nI am making a personal blog, something like obsidian publish, using obsidian as a cms. I already have many many attachments in the vault and can't change/rename every attachment's name one by one.\n\n### Reproduction\n\n\n\n### Expected behavior\n\nrender as a image\n\n### System Info\n\n```Text\nSystem (WSL):\r\n OS: Linux 5.15 Ubuntu 22.04.4 LTS 22.04.4 LTS (Jammy Jellyfish)\r\n CPU: (12) x64 AMD Ryzen 5 5600G with Radeon Graphics\r\n Memory: 4.80 GB / 7.45 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 20.16.0 - /usr/bin/node\r\n npm: 10.9.0 - /usr/bin/npm\r\n pnpm: 9.12.1 - /usr/bin/pnpm\r\n npmPackages:\r\n vitepress: ^1.4.1 => 1.4.1\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.",[3231],{"name":3152,"color":3153},4285,"image markdown not working as expected","2024-10-23T04:43:34Z","https://github.com/vuejs/vitepress/issues/4285",0.70815897,{"description":3238,"labels":3239,"number":3242,"owner":3155,"repository":3156,"state":3167,"title":3243,"updated_at":3244,"url":3245,"score":3246},"### Describe the bug\r\n\r\nI use some image in vue component, by using\r\n```js\r\nnew URL('@theme/public/my-image.jpg', import.meta.url).href\r\n```\r\nit works while `dev`, but not work while `preview` (after `build`), in the html file, it looks like this, \r\n```html\r\n\u003Cimg src=\"file://home/user/project/.vitepress/.temp/public/my-image.jpg\" />\r\n```\r\nrather than\r\n```html\r\n\u003Cimg src=\"/assets/my-image.47d9f72.jpg\" />\r\n```\r\n\r\nIs there some configurations or processing to resolve this problem?\r\n\r\n### Reproduction\r\n\r\nnone.\r\n\r\n### Expected behavior\r\n\r\nbuild successfully\r\n\r\n### System Info\r\n\r\n```sh\r\nOS: Windows 10/Ubuntu 20.04\r\nVitePress: 1.0.0-alpha75\r\nVue: 3.2.47\r\nelement-plus: 2.3.4\r\npnpm: 8.5.0\r\nnodejs: 18.16.0\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.",[3240,3241],{"name":3152,"color":3153},{"name":3194,"color":3195},2357,"After build, the src of img tag as 'file://home/user/xxx/.vitepress/.temp/xxx.png'","2023-08-12T00:04:09Z","https://github.com/vuejs/vitepress/issues/2357",0.7092215,{"description":3248,"labels":3249,"number":3251,"owner":3155,"repository":3156,"state":3167,"title":3252,"updated_at":3253,"url":3254,"score":3255},"### Describe the bug\n\n知乎热搜榜不更新\n这是itab 知乎\n\n\u003Cimg width=\"1579\" height=\"903\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7604efd0-49a5-495c-9fd6-8d24549f2e27\" />\n这是知乎网站的热搜榜\n\n\u003Cimg width=\"807\" height=\"942\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/092b0749-e7d2-4b00-bd5b-172b6725c892\" />\n\n### Reproduction\n\n希望能更新接口,获取最新热搜数据\n\n### Expected behavior\n\n希望能更新接口,获取最新热搜数据\n\n### System Info\n\n```Text\n1.6.20\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.",[3250],{"name":3152,"color":3153},4866,"知乎热搜榜不更新","2025-07-30T04:05:01Z","https://github.com/vuejs/vitepress/issues/4866",0.7117288,["Reactive",3257],{},["Set"],["ShallowReactive",3260],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fYcIk7V9nYIOzKDSQ0EnPGI_qq9IwKDcXgi0ZOfph09E":-1},"/vuejs/vitepress/1537"]