\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.",[3162],{"name":3146,"color":3147},4917,"Bug: Frequent triggering of redrawing of navigation bar icons","2025-08-21T09:14:41Z","https://github.com/vuejs/vitepress/issues/4917",0.6829939,{"description":3169,"labels":3170,"number":3171,"owner":3152,"repository":3153,"state":3172,"title":3173,"updated_at":3174,"url":3175,"score":3176},"### Describe the bug\n\nI wrote a markdown checklist using the following syntax and is rendered as an unordered list rather than a checklist.\r\n\r\n`index,md`\r\n\r\n```\r\n- [ ] Mercury\r\n- [ ] Saturn\r\n- [ ] Earth\r\n- [ ] Mars\r\n```\r\n\r\nWhat is rendered\r\n\r\n\u003Cimg width=\"274\" alt=\"Screen Shot 2021-10-11 at 8 46 06 PM\" src=\"https://user-images.githubusercontent.com/27181419/136872493-20cc4a0c-a1ac-4cdf-ac20-e6952f8f4819.png\">\r\n\n\n### Reproduction\n\nCreated basic project based on the steps on the [Getting Started](https://vitepress.vuejs.org/guide/getting-started.html).\n\n### Expected behavior\n\n- [ ] Mercury\r\n- [ ] Saturn\r\n- [ ] Earth\r\n- [ ] Mars\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 11.2.3\r\n CPU: (12) x64 Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz\r\n Memory: 1.18 GB / 16.00 GB\r\n Shell: 5.8 - /bin/zsh\r\n Binaries:\r\n Node: 14.15.0 - /usr/local/bin/node\r\n Yarn: 1.22.11 - /usr/local/bin/yarn\r\n npm: 7.20.0 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 94.0.4606.81\r\n Safari: 14.0.3\r\n npmPackages:\r\n vitepress: ^0.20.0 => 0.20.0\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[],413,"closed","Not Rendering markdown checklist","2023-01-21T14:25:12Z","https://github.com/vuejs/vitepress/issues/413",0.6500774,{"description":3178,"labels":3179,"number":3182,"owner":3152,"repository":3153,"state":3172,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### Describe the bug\r\n\r\nBuild blocking error happen on \"vitepress build docs\".\r\nWorks correctly and as intended on \"vitepress dev docs --port 8080\"\r\n\r\nTypeError: Failed to parse URL from [path]\r\n[cause]: TypeError [ERR_INVALID_URL]\r\n\r\n### Reproduction\r\n\r\nUse the regular Markdown File Inclusion with any file in any .md file, then try to build with \"vitepress build docs\".\r\n\r\nhttps://vitepress.dev/guide/markdown#markdown-file-inclusion\r\n\r\n### Expected behavior\r\n\r\nBuild concluding with success and no error displayed.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem: \r\n OS: Windows 10 10.0.19044 \r\n CPU: (4) x64 Intel(R) Core(TM) i5-7200U CPU @ 2.50GHz \r\n Memory: 1.94 GB / 7.62 GB \r\n Binaries: \r\n Node: 19.8.1 - C:\\Program Files\\nodejs\\node.EXE \r\n Yarn: 1.22.17 - ~\\AppData\\Roaming\\npm\\yarn.CMD \r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD \r\n Browsers: \r\n Edge: Spartan (44.19041.1266.0), Chromium (111.0.1661.62)\r\n Internet Explorer: 11.0.19041.1566 \r\n npmPackages: \r\n vitepress: ^1.0.0-alpha.62 => 1.0.0-alpha.62\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n\r\n\r\n\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.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3180,3181],{"name":3146,"color":3147},{"name":3149,"color":3150},2180,"Markdown \"@include\" throw \"ERR_INVALID_URL\" on \"vitepress build docs\"","2023-08-11T00:04:15Z","https://github.com/vuejs/vitepress/issues/2180",0.65766674,{"description":3188,"labels":3189,"number":3191,"owner":3152,"repository":3153,"state":3172,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### 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.",[3190],{"name":3146,"color":3147},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.6616608,{"description":3197,"labels":3198,"number":3202,"owner":3152,"repository":3153,"state":3172,"title":3203,"updated_at":3204,"url":3205,"score":3206},"### Describe the bug\r\n\r\nI locate the problematic line by commenting. When `{{ }}` appears, Vitepress parses the code block in the `` line incorrectly.\r\nFor example:\r\n```jsx\r\n\u003Cdiv style={{ opacity: 1}}/>\r\n```\r\n\r\n### Reproduction\r\n\r\nnull\r\n\r\n### Expected behavior\r\n\r\nSupport to use `{{}}` in `` inline code blocks.\r\n\r\n### System Info\r\n\r\n```shell\r\nnull\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n\r\n\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.",[3199],{"name":3200,"color":3201},"invalid","ffffff",1988,"Build Error: Not Support {{}} in ``","2023-03-04T00:04:19Z","https://github.com/vuejs/vitepress/issues/1988",0.6626048,{"description":3208,"labels":3209,"number":3211,"owner":3152,"repository":3153,"state":3172,"title":3212,"updated_at":3213,"url":3214,"score":3215},"### 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.",[3210],{"name":3146,"color":3147},4856,"vitepress not work for flowbite-vue","2025-07-25T10:13:26Z","https://github.com/vuejs/vitepress/issues/4856",0.664325,{"description":3217,"labels":3218,"number":3220,"owner":3152,"repository":3153,"state":3172,"title":3221,"updated_at":3222,"url":3223,"score":3224},"### Describe the bug\r\n\r\nThere is no problem in the development environment, but an error was thrown during packaging execution\r\n\u003Cimg width=\"1320\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/142566415/3a33fbd2-7d53-4bee-b0d0-db8ded2b047d\">\r\n\r\n### Reproduction\r\n\r\nFor development - npm run docs:dev\r\nFor build - npm run docs:build\r\n\r\nEquivalent stackblitz links:\r\n[https://stackblitz.com/edit/vite-dkrbry](https://stackblitz.com/edit/vite-dkrbry)\r\n\r\n### Expected behavior\r\n\r\nProduction should match with development.\r\n\r\n### System Info\r\n\r\n```Text\r\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.18.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 npmPackages:\r\n vitepress: latest => 1.0.0-rc.35\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.",[3219],{"name":3146,"color":3147},3425," XXX is not supported resolving ES modules imported from XXX","2024-01-18T00:04:43Z","https://github.com/vuejs/vitepress/issues/3425",0.6682584,{"description":3226,"labels":3227,"number":3229,"owner":3152,"repository":3153,"state":3172,"title":3230,"updated_at":3231,"url":3232,"score":3233},"### Describe the bug\n\nhttps://stackblitz.com/edit/vite-j7cesz?file=docs/index.md is the repro. Its `index.md` compiles just fine with some other established markdown compilers -- I tried pandoc and it worked well.\r\n\r\nI would like to know what's wrong with my markdown code! It can be that I don't understand the VitePress markdown syntax well enough, or maybe I am lucky to find a bug in the compiler 😉 I would like to provide additional info amap.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-j7cesz?file=docs/index.md\n\n### Expected behavior\n\nCompiles just fine.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Linux 5.15 Ubuntu 22.04.1 LTS 22.04.1 LTS (Jammy Jellyfish)\r\n CPU: (20) x64 12th Gen Intel(R) Core(TM) i7-12700H\r\n Memory: 5.91 GB / 7.61 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 19.2.0 - /usr/bin/node\r\n npm: 8.19.3 - /usr/bin/npm\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.30 => 1.0.0-alpha.30\r\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.",[3228],{"name":3146,"color":3147},1673,"VitePress does not compile a HTML-markdown mixed file saying that 'Element is missing end tag'","2023-01-21T14:17:06Z","https://github.com/vuejs/vitepress/issues/1673",0.6699613,{"description":3235,"labels":3236,"number":3240,"owner":3152,"repository":3153,"state":3172,"title":3241,"updated_at":3242,"url":3243,"score":3244},"### Describe the bug\n\n使用官方文档的部署脚本成功部署到Github Pages之后,此时如果配置使用自定义域名的话,访问时样式会丢失\n\n### Reproduction\n\n1. 博客目录结构如下所示:\u003Cbr />\r\n2. 配置文件如下所示:\u003Cbr /> \n\n### Expected behavior\n\n使用 Github 自带的 https://xihuanxiaorang.github.io/docs/ 访问就没有任何问题,如果是使用自定义域名 https://docs.xiaorang.fun/ 的话,样式就会丢失\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (4) x64 Intel(R) Core(TM) i5-5200U CPU @ 2.20GHz\r\n Memory: 659.73 MB / 3.92 GB\r\n Binaries:\r\n Node: 20.11.0 - E:\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - E:\\nodejs\\node_global\\yarn.CMD\r\n npm: 10.2.4 - E:\\nodejs\\npm.CMD\r\n pnpm: 8.14.3 - E:\\nodejs\\node_global\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.144)\r\n Internet Explorer: 11.0.19041.3636\r\n npmPackages:\r\n vitepress: 1.0.0-rc.40 => 1.0.0-rc.40\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":3238,"color":3239},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.67076516,["Reactive",3246],{},["Set"],["ShallowReactive",3249],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fgOkTUSbgLQvDOtygVAPb3yrQMvN64RYk9zJINzQsUfQ":-1},"/vuejs/vitepress/1923"]