\n\n\u003Cimg width=\"308\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/0e1beb6b-d06b-436c-b106-c924fead87ab\" />\n\n\u003Cimg width=\"931\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/aef6f71a-fa28-4b7c-b512-e6386e18159a\" />\n\n### Describe the solution you'd like\n\nIn my [pull request](https://github.com/vuejs/vitepress/pull/4630), I've introduced custom components that can be overridden in the `enhanceApp` function. In these custom components, I can add custom logic for rendering text, such as using the Vue compile function. \n\nAdditionally, I added a flag to skip the title update, allowing for custom logic implementation. \n\nPlease also see my PR: [https://github.com/vuejs/vitepress/pull/4630](https://github.com/vuejs/vitepress/pull/4630).\n\n### Describe alternatives you've considered\n\n_No response_\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [x] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[],4637,"Sidenav Components / Skip title update","2025-03-20T12:17:14Z","https://github.com/vuejs/vitepress/issues/4637",0.7353149,{"description":2896,"labels":2897,"number":2905,"owner":2871,"repository":2872,"state":2873,"title":2906,"updated_at":2907,"url":2908,"score":2909},"### Is your feature request related to a problem? Please describe.\r\n\r\nIt would be good to be able to add title text to the features section.\r\n\r\n### Describe the solution you'd like\r\n\r\nProvide a property for setting the header text for features section.\r\n\r\nExample:\r\n```\r\n---\r\nlayout: home\r\nfeatures-title: Features\r\nfeatures:\r\n - icon: 🛠️\r\n title: Simple and minimal, always\r\n details: Lorem ipsum...\r\n - icon:\r\n src: /cool-feature-icon.svg\r\n title: Another cool feature\r\n details: Lorem ipsum...\r\n - icon:\r\n dark: /dark-feature-icon.svg\r\n light: /light-feature-icon.svg\r\n title: Another cool feature\r\n details: Lorem ipsum...\r\n---\r\n```\r\n\r\n### Describe alternatives you've considered\r\n\r\nUsing `::before` in CSS for the VPHomeFeatures element and setting `content` works but feels hacky and isn't accessibility friendly.\r\n\r\nThis is how it looks like with the workaround, basically what I'd want:\r\n\r\n\r\n\r\n```\r\ndiv.VPHomeFeatures div.container::before {\r\n content: 'Reviews';\r\n font-size: 24px;\r\n font-weight: 600;\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.dev).\r\n- [X] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\r\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[2898,2901,2904],{"name":2899,"color":2900},"theme","0754FB",{"name":2902,"color":2903},"has-workaround","1B4515",{"name":2868,"color":2869},2788,"Ability to add title to features section","2025-03-02T18:11:08Z","https://github.com/vuejs/vitepress/issues/2788",0.73547494,{"description":2911,"labels":2912,"number":2917,"owner":2871,"repository":2872,"state":2873,"title":2918,"updated_at":2919,"url":2920,"score":2921},"### Describe the bug\n\nas we create too deep folders , appear the fault : file name too long while build\n\n### Reproduction\n\ncreate too deep folders\n\n### Expected behavior\n\nexcept can build success, even zhe folders is deep and each folder name is long\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.16299\r\n CPU: (6) x64 Intel(R) Core(TM) i5-8500 CPU @ 3.00GHz\r\n Memory: 5.00 GB / 15.89 GB\r\n Binaries:\r\n Node: 20.9.0 - D:\\program\\nvm1.1.11\\nodejs\\node.EXE\r\n npm: 10.1.0 - D:\\program\\nvm1.1.11\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (41.16299.1480.0)\r\n Internet Explorer: 11.0.16299.371\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.44 => 1.0.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.",[2913,2916],{"name":2914,"color":2915},"build","377ba8",{"name":2868,"color":2869},3763,"file name too long ","2025-03-02T18:09:25Z","https://github.com/vuejs/vitepress/issues/3763",0.73827744,{"description":2923,"labels":2924,"number":2927,"owner":2871,"repository":2872,"state":2873,"title":2928,"updated_at":2929,"url":2930,"score":2931},"### Is your feature request related to a problem? Please describe.\n\nIs that possible to add a special syntax to enable line wrapping in code block,\r\ne.g. something like `:::js:line-numbers` syntax, maybe `:::js:wrap`?\r\nOptionally provide a global configuration and `:::js:nowrap`, the same as `lineNumbers`?\r\n\r\nFor a single code block, I can wrap in a `\u003Cdiv>` and use inline style to force child `\u003Ccode>` to wrap by `!important`, but there's no way I can do so for `code-group`. So I guess we have to have a built-in syntax by vitepress to handle such things.\r\n\r\nAnd need to make sure it can be used together with `:line-numebrs` so it won't break anything\n\n### Describe the solution you'd like\n\ninline:\r\nto force wrap:\r\n```md\r\n```js:wrap\r\n```\r\nto force no-wrap:\r\n```md\r\n```js:nowrap\r\n```\r\n\r\nglobal (default to wrap or not):\r\n```ts\r\nexport default {\r\n markdown: {\r\n wrapCodeBlock: true\r\n }\r\n}\r\n```\n\n### Describe alternatives you've considered\n\n_No response_\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[2925,2926],{"name":2899,"color":2900},{"name":2868,"color":2869},2660,"✨Feature Request: Allow wrapping code block by some special syntax like `:::js:wrap`","2025-03-02T18:11:13Z","https://github.com/vuejs/vitepress/issues/2660",0.73979145,{"description":2933,"labels":2934,"number":2936,"owner":2871,"repository":2872,"state":2873,"title":2937,"updated_at":2938,"url":2939,"score":2940},"### Is your feature request related to a problem? Please describe.\n\n1. sometimes need use vue dynamic render highlight content like json list or some thing . if can provide component or function to do that, that will be great.\r\n2. tryed use the vue dynamic component it's not woking , can we use it ? how.\r\n1.有时候需要动态输出 markdown ,能不能加一个从vue 动态输出的功能 。 2. 动态组件用不了,怎么才能用vue 的动态组件\n\n### Describe the solution you'd like\n\n1. sometimes need use vue dynamic render highlight content like json list or some thing . if can provide component or function to do that, that will be great.\r\n2. tryed use the vue dynamic component it's not woking , can we use it ? how.\r\n1.有时候需要动态输出 markdown ,能不能加一个从vue 动态输出的功能 。 2. 动态组件用不了,怎么才能用vue 的动态组件\n\n### Describe alternatives you've considered\n\n_No response_\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[2935],{"name":2868,"color":2869},4253,"[Feature request] use vue render highlight section","2024-12-03T17:27:43Z","https://github.com/vuejs/vitepress/issues/4253",0.744263,{"description":2942,"labels":2943,"number":2947,"owner":2871,"repository":2872,"state":2948,"title":2949,"updated_at":2950,"url":2951,"score":2952},"### Describe the bug\n\nURI is malformed\n\n### Reproduction\n\n新建文章 4%4.md ,然后编译会报错,无法打开页面。\n\n### Expected behavior\n\n期望正常打开页面,不提示报错信息:URI is malformed\n\n### System Info\n\n```Text\nMacOS chrome\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.",[2944],{"name":2945,"color":2946},"bug: pending triage","e99695",4006,"closed","md文件名包含百分号会报错","2024-07-09T04:41:50Z","https://github.com/vuejs/vitepress/issues/4006",0.69809717,{"description":2954,"labels":2955,"number":2957,"owner":2871,"repository":2872,"state":2948,"title":2958,"updated_at":2959,"url":2960,"score":2961},"### Describe the bug\n\n```sh\r\n\r\n vitepress v1.2.2\r\n\r\n✓ building client + server bundles...\r\n✖ rendering pages...\r\nbuild error:\r\nstr.replace is not a function\r\nTypeError: str.replace is not a function\r\n at escapeHtml$1 (file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:19945:14)\r\n at file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46689:24\r\n at Array.map (\u003Canonymous>)\r\n at renderAttrs (file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46687:29)\r\n at file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46671:33\r\n at Array.map (\u003Canonymous>)\r\n at renderHead (file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46670:10)\r\n at renderPage (file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46625:13)\r\n at async pMap.concurrency (file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:46770:11)\r\n at async file:///Users/Theo-Messi/Desktop/Theo-Docs/node_modules/.pnpm/vitepress@1.2.2_@algolia+client-search@4.23.3_@types+node@20.12.12_postcss@8.4.38_search-insi_kwabrcozogw3xguwc456c4glc4/node_modules/vitepress/dist/node/serve-BwR5EPUJ.js:2618:20\r\n ELIFECYCLE Command failed with exit code 1.\r\n```\n\n### Reproduction\n\nthis is my `package.json`\r\n```json\r\n{\r\n \"scripts\": {\r\n \"dev\": \"vitepress dev\",\r\n \"build\": \"vitepress build\",\r\n \"preview\": \"vitepress preview\",\r\n \"prettier\": \"pnpm exec prettier . --write\"\r\n },\r\n \"devDependencies\": {\r\n \"@shikijs/vitepress-twoslash\": \"^1.6.0\",\r\n \"prettier\": \"3.2.5\",\r\n \"vitepress\": \"1.2.2\",\r\n \"vitepress-plugin-google-analytics\": \"^1.0.2\"\r\n },\r\n \"dependencies\": {\r\n \"@types/node\": \"^20.12.12\",\r\n \"@vercel/analytics\": \"^1.3.1\",\r\n \"lint-staged\": \"^15.2.5\",\r\n \"simple-git-hooks\": \"^2.11.1\",\r\n \"vue\": \"^3.4.27\"\r\n },\r\n \"simple-git-hooks\": {\r\n \"pre-commit\": \"pnpm lint-staged\"\r\n },\r\n \"lint-staged\": {\r\n \"*\": [\r\n \"prettier --write --ignore-unknown\"\r\n ]\r\n }\r\n}\r\n```\n\n### Expected behavior\n\nIt should build fine\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.2.1\r\n CPU: (6) x64 Intel(R) Core(TM) i5-8500B CPU @ 3.00GHz\r\n Memory: 32.25 MB / 8.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 21.1.0 - ~/.nvm/versions/node/v21.1.0/bin/node\r\n Yarn: 1.22.22 - /usr/local/bin/yarn\r\n npm: 10.2.0 - ~/.nvm/versions/node/v21.1.0/bin/npm\r\n pnpm: 9.1.2 - /usr/local/bin/pnpm\r\n Browsers:\r\n Chrome: 124.0.6367.93\r\n Safari: 17.2.1\r\n npmPackages:\r\n vitepress: 1.2.2 => 1.2.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.",[2956],{"name":2945,"color":2946},3921,"upgrading to vitepress v1.2.2 build error","2024-06-03T04:41:57Z","https://github.com/vuejs/vitepress/issues/3921",0.70874244,{"description":2963,"labels":2964,"number":2966,"owner":2871,"repository":2872,"state":2948,"title":2967,"updated_at":2968,"url":2969,"score":2970},"### Describe the bug\n\nThe [docs](https://vitepress.vuejs.org/config/theme-configs#outline) specify that you can pick the levels at which to outline. However, even if you specify h1, it will not generate an outline for that level:\r\n\r\n```js\r\nexport default {\r\n themeConfig: {\r\n outline: [1,3]\r\n }\r\n}\r\n```\r\n\r\nThis was already mentioned as needing to be fixed in #954 and claimed to be fixed/added in #965.\n\n### Reproduction\n\n- Set the theme config as shown above to include h1 - h3 in the outline\r\n- Create an MD file with an h1 (or #) heading\n\n### Expected behavior\n\nShould see all headings h1 - h3 in the outline\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: (6) x64 AMD FX(tm)-6300 Six-Core Processor\r\n Memory: 6.91 GB / 31.25 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 16.16.0 - /usr/local/bin/node\r\n Yarn: 1.22.19 - ~/.yarn/bin/yarn\r\n npm: 8.15.0 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 105.0.5195.125\r\n Firefox: 105.0.1\n```\n\n\n### Additional context\n\nThis _might_ be an error/issue with the [mdit-vue](https://github.com/mdit-vue/mdit-vue) package.\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.",[2965],{"name":2945,"color":2946},1434,"Outlines Do Not Include h1 Even When Specified","2023-01-21T14:16:51Z","https://github.com/vuejs/vitepress/issues/1434",0.71430063,["Reactive",2972],{},["Set"],["ShallowReactive",2975],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fg1GUF-GJk__h-cf_49yoZ4BQPa0a03KMdISfJ9TPl24":-1},"/vuejs/vitepress/3082"]