\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.6583692,{"description":3157,"labels":3158,"number":3163,"owner":3149,"repository":3150,"state":3164,"title":3165,"updated_at":3166,"url":3167,"score":3168},"### 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.",[3159,3160],{"name":3146,"color":3147},{"name":3161,"color":3162},"stale","ededed",2180,"closed","Markdown \"@include\" throw \"ERR_INVALID_URL\" on \"vitepress build docs\"","2023-08-11T00:04:15Z","https://github.com/vuejs/vitepress/issues/2180",0.65346926,{"description":3170,"labels":3171,"number":3172,"owner":3149,"repository":3150,"state":3164,"title":3173,"updated_at":3174,"url":3175,"score":3176},"### Describe the bug\r\n\r\n不支持行内这种**`XXX`**高亮加加粗\r\n\r\n### Reproduction\r\n\r\n不支持:aaa**`XXX`**bbb\r\n支持:aaa **`XXX`** bbb (**和其他文本之间需要加空格)\r\n\r\n### Expected behavior\r\n\r\nnull\r\n\r\n### System Info\r\n\r\n```Text\r\nnull\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.",[],3762,"不支持行内这种**`XXX`**高亮加加粗","2024-04-28T12:25:05Z","https://github.com/vuejs/vitepress/issues/3762",0.65581524,{"description":3178,"labels":3179,"number":3184,"owner":3149,"repository":3150,"state":3164,"title":3185,"updated_at":3186,"url":3187,"score":3188},"### Describe the bug\r\n\r\nvitepress not support TODO\r\n\r\nwhen i use `- [ ]` in markdown, it wasn't rendered correctly, it's recognized as a list, just like this:\r\n\u003Cimg width=\"282\" alt=\"image\" src=\"https://user-images.githubusercontent.com/37357188/218241878-e9fbec7c-9848-4166-80fe-8370421d8ce6.png\">\r\n\r\nIt should be identified as\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\njust like this\r\n\r\n- [x] TODO-1\r\n- [x] TODO-2\r\n- [ ] TODO-1\r\n\r\nbut in vitpress\r\n\r\n\r\n\r\n### Expected behavior\r\n\r\njust like on github\r\n\r\n- [x] TODO-1\r\n- [x] TODO-2\r\n- [ ] TODO-1\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 12.6.3\r\n CPU: (8) x64 Intel(R) Core(TM) i5-8259U CPU @ 2.30GHz\r\n Memory: 87.81 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.17.0 - ~/.nvm/versions/node/v16.17.0/bin/node\r\n Yarn: 1.22.19 - ~/.nvm/versions/node/v16.17.0/bin/yarn\r\n npm: 8.15.0 - ~/.nvm/versions/node/v16.17.0/bin/npm\r\n Browsers:\r\n Chrome: 109.0.5414.119\r\n Edge: 97.0.1072.62\r\n Firefox: 77.0.1\r\n Safari: 16.3\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.45 => 1.0.0-alpha.45\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.",[3180,3183],{"name":3181,"color":3182},"has-workaround","1B4515",{"name":3161,"color":3162},1923,"TODO list todo is not supported","2023-08-12T00:04:28Z","https://github.com/vuejs/vitepress/issues/1923",0.6637599,{"description":3190,"labels":3191,"number":3195,"owner":3149,"repository":3150,"state":3164,"title":3196,"updated_at":3197,"url":3198,"score":3199},"### Describe the bug\r\n\r\nI try to use SolidJS in vitepress,\r\nwhen in development mode, it works ok,\r\nbut when I build, during the render process,\r\nit throws error like:\r\nSyntaxError: The requested module 'solid-js/web' does not provide an export named 'effect'\r\n at async render (file:///home/projects/vite-hnzcih/docs/.vitepress/.temp/app.js:4605:5)\r\n at async renderPage (file:///home/projects/vite-hnzcih/node_modules/vitepress/dist/node/serve-afe9b056.js:41460:19)\r\n at async Promise.all (index 1)\r\n at async Module.build (file:///home/projects/vite-hnzcih/node_modules/vitepress/dist/node/serve-afe9b056.js:42209:7)\r\n\r\n\r\n\r\nimport { template, render } from 'solid-js/web';\r\n ^^^^^^^^\r\nSyntaxError: The requested module 'solid-js/web' does not provide an export named 'template'\r\n\r\n\r\n\r\nI don't know why.\r\nIn pure vite program, it builds success.\r\nIn the reproduction, it seems can't resolve solid-js/web\r\n\r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/edit/vite-hnzcih?file=docs/components/Home.tsx\r\n\r\nrun \r\n```\r\nnpm install && npm run docs:dev\r\n```\r\n it renders ok,\r\nbut run\r\n```\r\n npm install && npm run docs:build\r\n```\r\nit will throw error.\r\n\r\n### Expected behavior\r\n\r\nI hope it builds successfully.\r\n\r\n### System Info\r\n\r\n```shell\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: 16.14.2 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 7.17.0 - /usr/local/bin/npm\r\n npmPackages:\r\n vitepress: latest => 1.0.0-alpha.23\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nAlter ‘solid-js’ from ‘devDependencies’ to ‘dependencies’ still wasn't working.\r\n\r\n\r\n``` \r\n \"dependencies\": {\r\n \"@babel/core\": \"^7.19.6\",\r\n \"babel-preset-solid\": \"^1.6.1\",\r\n \"solid-js\": \"^1.6.1\",\r\n \"vite-plugin-solid\": \"^2.4.0\",\r\n \"vitepress\": \"latest\"\r\n }\r\n```\r\n\r\n```\r\nimport { defineConfig } from 'vite';\r\nimport solidPlugin from 'vite-plugin-solid';\r\n\r\nexport default defineConfig({\r\n plugins: [solidPlugin()],\r\n server: {\r\n port: 3000,\r\n },\r\n build: {\r\n target: 'esnext',\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.",[3192],{"name":3193,"color":3194},"invalid","ffffff",1586,"use solidjs in vitepress build error","2023-01-28T00:04:04Z","https://github.com/vuejs/vitepress/issues/1586",0.6657805,{"description":3201,"labels":3202,"number":3206,"owner":3149,"repository":3150,"state":3164,"title":3207,"updated_at":3208,"url":3209,"score":3210},"### Describe the bug\n\nAfter executing the packaging command, the index.html in the running dist folder found that all the js in the web page were invalid.\r\nAnd there's a lot of errors on the page\n\n### Reproduction\n\n`npm run docs:build`\n\n### Expected behavior\n\nI hope it works correctly\n\n### System Info\n\n```Text\nwindows11 chrome\n```\n\n\n### Additional context\n\n\r\n\r\nhttps://github.com/vuejs/vitepress/assets/139530289/d008c5da-ead0-4017-816f-5eea9d449026\r\n\r\n\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":3204,"color":3205},"need more info","bdbefc",3394,"Js is Invalid","2024-02-21T00:04:29Z","https://github.com/vuejs/vitepress/issues/3394",0.6706768,{"description":3212,"labels":3213,"number":3215,"owner":3149,"repository":3150,"state":3164,"title":3216,"updated_at":3217,"url":3218,"score":3219},"### Describe the bug\n\n布局 home ,build以后不显示,最新版本\n\n### Reproduction\nlayout: home\n\nhero:\n name: xxx\n image:\n src: /logo.png\n tagline: xxx\n actions:\n - theme: brand\n text: xxx\n link: /x/xx\n\n\n### Expected behavior\n\n希望正常显示 layout:home\n\n### System Info\n\n```Text\n\"vitepress\": \"^2.0.0-alpha.5\",\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.",[3214],{"name":3204,"color":3205},4744,"布局 home ,build以后不显示,最新版本","2025-05-13T03:47:00Z","https://github.com/vuejs/vitepress/issues/4744",0.6727722,{"description":3221,"labels":3222,"number":3224,"owner":3149,"repository":3150,"state":3164,"title":3225,"updated_at":3226,"url":3227,"score":3228},"### Describe the bug\n\nI referenced a globally registered component in the markdown document of vitepress. When I used it, the error was reported as follows:\r\n**[vitepress] Internal server error: At least one \u003Ctemplate> or \u003Cscript> is required in a single file component.**\r\n\r\n\r\n\n\n### Reproduction\n\nCreate vite.config.js in the vitepress root directory, the content is as follows:\r\n\r\n```\r\nimport { defineConfig } from \"vite\";\r\nimport vueJsx from \"@vitejs/plugin-vue-jsx\";\r\nimport vue from \"@vitejs/plugin-vue\"\r\nexport default defineConfig({\r\n plugins: [\r\n vue(),\r\n vueJsx(),\r\n ],\r\n});\r\n```\n\n### Expected behavior\n\nRender component content correctly\n\n### System Info\n\n```shell\nnode 16\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.",[3223],{"name":3204,"color":3205},2095,"vitepress not support jsx file?","2023-03-29T00:04:14Z","https://github.com/vuejs/vitepress/issues/2095",0.6741262,{"description":3230,"labels":3231,"number":3233,"owner":3149,"repository":3150,"state":3164,"title":3234,"updated_at":3235,"url":3236,"score":3237},"### 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.",[3232],{"name":3161,"color":3162},826,"support adding attributes to code blocks","2023-08-11T00:04:28Z","https://github.com/vuejs/vitepress/issues/826",0.6771976,{"description":3239,"labels":3240,"number":3242,"owner":3149,"repository":3150,"state":3164,"title":3243,"updated_at":3244,"url":3245,"score":3246},"### Describe the bug\n\n\r\n\r\n打包报错css问题,css没有任何问题,theme里全局引入组件库的,版本\"vitepress\": \"1.0.0-beta.1\"\n\n### Reproduction\n\nv \"vitepress\": \"1.0.0-beta.1\"\n\n### Expected behavior\n\n正常打包\n\n### System Info\n\n```sh\nnpm run build\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.",[3241],{"name":3146,"color":3147},2439,"打包报错Unexpected token '.' 问题","2023-06-08T00:04:08Z","https://github.com/vuejs/vitepress/issues/2439",0.68065655,["Reactive",3248],{},["Set"],["ShallowReactive",3251],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fujNE4UheKaa2VHwX9W-mY2j3nqFTzqVEQHOS0NzqOTw":-1},"/vuejs/vitepress/1988"]