\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.67673653,{"description":3169,"labels":3170,"number":3172,"owner":3152,"repository":3153,"state":3173,"title":3174,"updated_at":3175,"url":3176,"score":3177},"### Describe the bug\n\nGetting \r\nSyntaxError: The requested module 'shiki' does not provide an export named 'isPlaintext'\r\nwhen running npx vitepress init \r\n \r\n\u003Cimg width=\"730\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/25881429/1ece1ea3-815d-45f1-8ce3-c4f57f3f7ec8\">\r\n\n\n### Reproduction\n\nFollow the steps mentioned here: https://vitepress.dev/guide/getting-started\r\n\r\ninstall vitepress\r\n1. npm add -D vitepress\r\nStart the wizard\r\n2. npx vitepress init\r\n\n\n### Expected behavior\n\nSuccesful init of vitepress\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.2.1\r\n CPU: (8) arm64 Apple M1\r\n Memory: 79.88 MB / 16.00 GB\r\n Shell: 3.6.1 - /opt/homebrew/bin/fish\r\n Binaries:\r\n Node: 21.6.1 - /opt/homebrew/bin/node\r\n npm: 10.2.4 - /opt/homebrew/bin/npm\r\n Browsers:\r\n Chrome: 121.0.6167.139\r\n Safari: 17.2.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.41 => 1.0.0-rc.41\n```\n\n\n### Additional context\n\nI saw that it was fixed here https://github.com/vuejs/vitepress/pull/3550 some hours ago, but still i am getting this error\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.",[3171],{"name":3146,"color":3147},3552,"closed","SyntaxError: The requested module 'shiki' does not provide an export named 'isPlaintext'","2024-02-14T00:04:26Z","https://github.com/vuejs/vitepress/issues/3552",0.6517854,{"description":3179,"labels":3180,"number":3182,"owner":3152,"repository":3153,"state":3173,"title":3183,"updated_at":3184,"url":3185,"score":3186},"### Describe the bug\n\n项目中使用了 highlightjs 作为代码预览高亮工具。开发时并未发现异常,但是在构建时提示错误\r\n```text\r\nbuild error:\r\n file:///C:/demo-code/vitepress-error/docs/.vitepress/.temp/app.js:7\r\nimport hljsVuePlugin from \"@highlightjs/vue-plugin\";\r\n ^^^^^^^^^^^^^\r\nSyntaxError: The requested module '@highlightjs/vue-plugin' does not provide an export named 'default'\r\n at ModuleJob._instantiate (node:internal/modules/esm/module_job:128:21)\r\n at async ModuleJob.run (node:internal/modules/esm/module_job:194:5)\r\n at async Promise.all (index 0)\r\n at async ESMLoader.import (node:internal/modules/esm/loader:385:24)\r\n at async build (file:///C:/demo-code/vitepress-error/node_modules/.pnpm/vitepress@1.0.0-alpha.45/node_modules/vitepress/dist/node/serve-ebe7f464.js:42286:24)\r\n ELIFECYCLE Command failed with exit code 1.\r\n```\r\n一开始我怀疑是该库存在问题,但是在常规 vue 应用中使用并构建都是没问题的。\n\n### Reproduction\n\n最小复现\r\n```text\r\nhttps://github.com/SaberA1ter/vitepress-error-demo\r\n```\r\n组件在 ```docs/.vitepress/theme/index.js``` 中注册,报错也是发生于此\n\n### Expected behavior\n\n开发正常,但是构建报错。\n\n### System Info\n\n```shell\nwin11\r\n\r\nnodejs: v16.15.1\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.",[3181],{"name":3146,"color":3147},1905,"build 报错: SyntaxError: The requested module '@highlightjs/vue-plugin' does not provide an export named 'default'","2023-02-17T00:04:39Z","https://github.com/vuejs/vitepress/issues/1905",0.66098356,{"description":3188,"labels":3189,"number":3191,"owner":3152,"repository":3153,"state":3173,"title":3192,"updated_at":3193,"url":3194,"score":3195},"### Describe the bug\r\n\r\nHi, I am trying to import and use a custom Markdown renderer inside a component but it looks like the `createMarkdownRenderer` function is not exported.\r\n\r\n```\r\nUncaught SyntaxError: The requested module '/@fs/Users/xyz/.github/xyz/node_modules/vitepress/dist/client/index.js?v=61ac765b' does not provide an export named 'createMarkdownRenderer' (at EndpointExample.vue:2:10)\r\n```\r\n\r\nHowever, according to TypeScript types exported from VitePress, `createMarkdownRenderer` should be available for use.\r\n\r\n### Reproduction\r\n\r\n```vue\r\n\u003Cscript setup lang=\"ts\">\r\nimport { createMarkdownRenderer } from \"vitepress\";\r\n\r\nconst props = defineProps\u003C{\r\n requests: { type: string; content: string; }[];\r\n response: string;\r\n}>();\r\n\r\n// `createMarkdownRenderer` is not exported from vitepress.\r\nconst md = await createMarkdownRenderer(\".\");\r\nconst response = md.render(props.response);\r\n\u003C/script>\r\n```\r\n\r\n### Expected behavior\r\n\r\nThe function `createMarkdownRenderer` should be exported as it is available from TypeScript types. If it should not, then remove the `createMarkdownRenderer` type export.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 12.6\r\n CPU: (8) arm64 Apple M1 Pro\r\n Memory: 116.75 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 18.12.1 - ~/.nvm/versions/node/v18.12.1/bin/node\r\n Yarn: 1.22.19 - ~/.yarn/bin/yarn\r\n npm: 8.19.2 - ~/.nvm/versions/node/v18.12.1/bin/npm\r\n Browsers:\r\n Brave Browser: 108.1.46.144\r\n Chrome: 108.0.5359.124\r\n Firefox: 103.0.2\r\n Safari: 16.0\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nPlease note that I am trying to create a custom `markdownRenderer` so that I can create a code render from my component props.\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.",[3190],{"name":3146,"color":3147},1752,"The requested module does not provide an export named 'createMarkdownRenderer'","2023-01-21T14:16:58Z","https://github.com/vuejs/vitepress/issues/1752",0.6674444,{"description":3197,"labels":3198,"number":3200,"owner":3152,"repository":3153,"state":3173,"title":3201,"updated_at":3202,"url":3203,"score":3204},"### Describe the bug\n\nupdate \"vitepress\": \"^1.0.0-alpha.6\"\r\nin theme index.js\r\nimport naive from 'naive-ui'\r\n enhanceApp({ app }) {\r\n app.use(naive)\r\n }\r\n\r\nnpm run docs:build\r\n\r\n✓ building client + server bundles...\r\n(node:31512) Warning: To load an ES module, set \"type\": \"module\" in the package.json or use the .mjs extension.\r\n(Use `node --trace-warnings ...` to show where the warning was created)\r\nbuild error:\r\n C:\\Users\\A0\\Documents\\vitePress\\node_modules\\naive-ui\\es\\index.js:1\r\nexport { default, install } from './preset';\r\n^^^^^^\r\n\r\nSyntaxError: Unexpected token 'export'\r\n at wrapSafe (node:internal/modules/cjs/loader:1032:15)\r\n at Module._compile (node:internal/modules/cjs/loader:1067:27)\r\n at Object.Module._extensions..js (node:internal/modules/cjs/loader:1157:10)\r\n at Module.load (node:internal/modules/cjs/loader:981:32)\r\n at Function.Module._load (node:internal/modules/cjs/loader:822:12)\r\n at ModuleWrap.\u003Canonymous> (node:internal/modules/esm/translators:168:29)\r\n at ModuleJob.run (node:internal/modules/esm/module_job:197:25)\r\n at async Promise.all (index 0)\r\n at async ESMLoader.import (node:internal/modules/esm/loader:337:24)\r\n\r\n\n\n### Reproduction\n\nnpm run docs:build\n\n### Expected behavior\n\ntheme Full Import naive-ui \r\nbuild success\n\n### System Info\n\n```shell\n\"vitepress\": \"^1.0.0-alpha.6\"\r\n node : 14.16.2\r\n browsers : chrome\r\n system windows\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.",[3199],{"name":3146,"color":3147},1399,"import naive from 'naive-ui' build error: export { default, install } from './preset'; ^^^^^^ SyntaxError: Unexpected token 'export'","2023-01-21T14:25:25Z","https://github.com/vuejs/vitepress/issues/1399",0.67152995,{"description":3206,"labels":3207,"number":3209,"owner":3152,"repository":3153,"state":3173,"title":3210,"updated_at":3211,"url":3212,"score":3213},"### Describe the bug\n\nAfter updating to vitepress@1.0.0-rc.40 (and still confirmed in vitepress@1.0.0-rc.42), we can no longer use vitepress's development mode via `vitepress dev`.\r\nWhile the CLI app runs without visible errors, the browser only shows an empty screen. In the browser console, the following warnings and error are shown:\r\n\u003Cimg width=\"662\" alt=\"vitepress-error\" src=\"https://github.com/vuejs/vitepress/assets/12949268/f6b73163-1a5f-4890-8c28-0c5744000ef3\">\r\nAs this does not seem to originate from our own code, we are not sure we can do anything about it. At the moment, we avoid the issue by pinning vitepress to vitepress@1.0.0-rc.39.\r\n\r\n\n\n### Reproduction\n\n```shell\r\ngit clone git@github.com:rollup/rollup.git\r\ncd rollup\r\nnpm install --ignore-scripts\r\nnpm install vitepress@latest\r\nnpm run dev\r\n```\n\n### Expected behavior\n\nOpening http://localhost:5173/ in the browser shows the Rollup website.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.3.1\r\n CPU: (12) arm64 Apple M2 Max\r\n Memory: 14.80 GB / 64.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.5.1 - ~/.asdf/installs/nodejs/20.5.1/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 9.8.0 - ~/.asdf/plugins/nodejs/shims/npm\r\n pnpm: 8.14.1 - ~/.asdf/installs/nodejs/20.5.1/bin/pnpm\r\n Browsers:\r\n Chrome: 121.0.6167.184\r\n Safari: 17.3.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.42 => 1.0.0-rc.42\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.",[3208],{"name":3146,"color":3147},3579,"vitepress@1.0.0-rc.40+ breaks vitepress dev","2024-02-27T00:05:56Z","https://github.com/vuejs/vitepress/issues/3579",0.67539614,{"description":3215,"labels":3216,"number":3218,"owner":3152,"repository":3153,"state":3173,"title":3219,"updated_at":3220,"url":3221,"score":3222},"### Describe the bug\n\nUpon following the starter instructions in the [docs](https://vitepress.vuejs.org/guide/getting-started.html), running `yarn docs:dev` yields a blank webpage at `localhost:3000` with the error shown below in the console.\r\n\r\n\r\n\n\n### Reproduction\n\nFollowing the instructions outlined on the Getting Started page on [vitepress.vuejs.org](https://vitepress.vuejs.org/guide/getting-started.html).\n\n### Expected behavior\n\n\"Hello Vitepress\" should be rendered to the screen with no error messages in the console.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Linux 5.13 Fedora 34 (Workstation Edition) 34 (Workstation Edition)\r\n CPU: (8) x64 Intel(R) Core(TM) i7-10510U CPU @ 1.80GHz\r\n Memory: 2.30 GB / 15.28 GB\r\n Container: Yes\r\n Shell: 5.1.0 - /bin/bash\r\n Binaries:\r\n Node: 14.17.0 - /usr/bin/node\r\n Yarn: 1.22.5 - /usr/bin/yarn\r\n npm: 7.20.5 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 92.0.4515.131\r\n Firefox: 90.0.2\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.",[3217],{"name":3146,"color":3147},355,"import not found: defineEmit","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/355",0.67647916,{"description":3224,"labels":3225,"number":3227,"owner":3152,"repository":3153,"state":3173,"title":3228,"updated_at":3229,"url":3230,"score":3231},"### 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.",[3226],{"name":3146,"color":3147},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.6807959,{"description":3233,"labels":3234,"number":3236,"owner":3152,"repository":3153,"state":3173,"title":3237,"updated_at":3238,"url":3239,"score":3240},"### Describe the bug\n\nyarn docs:dev\r\n\r\nBrowser display error:\r\n\r\n\n\n### Reproduction\n\nFollow the getting started case, which is https://vitepress.vuejs.org/guide/getting-started.html\n\n### Expected behavior\n\nNormal display index.md\n\n### System Info\n\n```shell\n~~~\r\nPS G:\\vitePress> npx envinfo --system --npmPackages vitepress --binaries --browsers\r\nNeed to install the following packages:\r\n envinfo\r\nOk to proceed? (y) y\r\n\r\n System:\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.91 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.15.6 => 0.15.6\r\n~~~\n```\n\n\n### Additional context\n\n\r\n\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.",[3235],{"name":3146,"color":3147},359,"Using the simplest example, an error occurred","2023-01-21T16:22:13Z","https://github.com/vuejs/vitepress/issues/359",0.68087465,["Reactive",3242],{},["Set"],["ShallowReactive",3245],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fRlS2VoKkzQGEm3oY5qkIocCTaletlIXK-cHUwPEbp4Q":-1},"/vuejs/vitepress/3486"]