\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,"vuejs","vitepress","open","Sidenav Components / Skip title update","2025-03-20T12:17:14Z","https://github.com/vuejs/vitepress/issues/4637",0.7549765,{"description":2876,"labels":2877,"number":2884,"owner":2868,"repository":2869,"state":2870,"title":2885,"updated_at":2886,"url":2887,"score":2888},"### Is your feature request related to a problem? Please describe.\n\nGitHub-flavored Alerts features 5 colors while the custom containers only feature 4. I would like to avoid mixing the syntaxes to create colored containers.\n\n### Describe the solution you'd like\n\nAdd `important` custom containers that feature the same color as their github counterpart.\n\n### Describe alternatives you've considered\n\nMixing syntaxes.\r\nUsing the `tip` custom container.\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.",[2878,2881],{"name":2879,"color":2880},"build","377ba8",{"name":2882,"color":2883},"stale","ededed",3928,"Add `important` to custom containers","2025-03-02T18:09:03Z","https://github.com/vuejs/vitepress/issues/3928",0.7551167,{"description":2890,"labels":2891,"number":2893,"owner":2868,"repository":2869,"state":2870,"title":2894,"updated_at":2895,"url":2896,"score":2897},"有些需求需要动态修改 文档中的内容,通过插槽的方式实现会受到 markdown格式的 影响\r\n\r\n我当前的实现方式是 \r\n\r\n可读性很差,\r\n而且 `\u003Ctemplate>` 标签不可缩进 应该是bug\r\n\r\n如果可以提供一些组件出来就好了,可读性将得到提升\r\n\r\njust like :\r\n```\r\nconst json_txt = ref( ... som json txt )\r\n\u003Cpress-code type=\"json\">\r\n{{ json_txt }}\r\n\u003C/press-code>\r\n```\r\n\r\nnow the json_txt is responsive",[2892],{"name":2882,"color":2883},4396,"提供/暴露 一些 文档中常用的组件,在vue中使用,这样展示内容就可以是响应式的了,内容以插槽的方式传入","2025-01-20T11:04:38Z","https://github.com/vuejs/vitepress/issues/4396",0.7616474,{"description":2899,"labels":2900,"number":2905,"owner":2868,"repository":2869,"state":2870,"title":2906,"updated_at":2907,"url":2908,"score":2909},"### Describe the bug\n\n# Issue: Cannot download files from public folder in version` v.1.3.4`\r\n\r\n## Description\r\nI encountered an issue after updating **Vitepress** from version `v.1.2.3` to `v.1.3.4` where I can no longer download files from the public folder on my Vitepress site. \r\n\r\n\r\n## Screenshots \r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\n\n### Reproduction\n\n# Steps to reproduce\r\n1. Run Vitepress on Gitlab Pages\r\n2. Update Vitepress from `v.1.2.3` to `v.1.3.4`\r\n3. Attempt to download a file from the public folder. \r\n4. The error message \"file not available on the page\" appears \r\n\r\n\n\n### Expected behavior\n\n# Expected behavior\r\nFiles from the public folder should be downloadable, as they were in version `v.1.2.3`. \r\n\r\n## Workaraound \r\nDowngrading back to `v.1.2.3` resolve the issue and restore file downloads from the public folder. \n\n### System Info\n\n```Text\nVitepress v.1.3.4\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.",[2901,2904],{"name":2902,"color":2903},"bug: pending triage","e99695",{"name":2882,"color":2883},4230,"Download public files - File not available on the page (Gitlab Pages)","2024-10-26T17:17:15Z","https://github.com/vuejs/vitepress/issues/4230",0.7625501,{"description":2911,"labels":2912,"number":2915,"owner":2868,"repository":2869,"state":2870,"title":2916,"updated_at":2917,"url":2918,"score":2919},"### Describe the bug\n\nI have a `/guide` path redirecting to one of first pages like `guide/product` and it works if I click action button, feature button or just change the route.\r\n\r\nHowever it doesn't work if I click a nav button\n\n### Reproduction\n\n```\r\nimport { defineConfig } from 'vitepress'\r\n\r\n// https://vitepress.dev/reference/site-config\r\nexport default defineConfig({ \r\n rewrites: {\r\n '/guide': \"guide/intro\"\r\n },\r\n themeConfig: {\r\n // https://vitepress.dev/reference/default-theme-config\r\n nav: [\r\n { text: 'Home', link: '/' },\r\n { text: 'Guide', link: '/guide' }\r\n ],\r\n\r\n sidebar: {\r\n\r\n \"/guide\": [\r\n {\r\n text: 'Introduction',\r\n items: [\r\n { text: 'Intro?', link: '/guide/intro/' },\r\n ]\r\n },\r\n]\r\n\r\n }\r\n }\r\n\r\n)\r\n```\n\n### Expected behavior\n\nI expect that clicking a link in the nav would handle it same way as it handles it everywhere else on the site\n\n### System Info\n\n```Text\nSystem:\r\n OS: Linux 5.15 Debian GNU/Linux 12 (bookworm) 12 (bookworm)\r\n CPU: (2) x64 12th Gen Intel(R) Core(TM) i7-1265U\r\n Memory: 7.76 GB / 11.69 GB\r\n Container: Yes\r\n Shell: 5.2.15 - /bin/bash\r\n Binaries:\r\n Node: 22.9.0 - /usr/local/bin/node\r\n Yarn: 1.22.22 - /usr/local/bin/yarn\r\n npm: 10.8.3 - /usr/local/bin/npm\r\n pnpm: 9.12.1 - /usr/local/share/npm-global/bin/pnpm\r\n npmPackages:\r\n vitepress: ^1.5.0 => 1.5.0\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,2914],{"name":2902,"color":2903},{"name":2882,"color":2883},4364,"Links in the Nav bar do not support rewrites","2024-12-27T13:10:18Z","https://github.com/vuejs/vitepress/issues/4364",0.76792395,{"description":2921,"labels":2922,"number":2924,"owner":2868,"repository":2869,"state":2870,"title":2925,"updated_at":2926,"url":2927,"score":2928},"### Is your feature request related to a problem? Please describe.\n\n我的某个包在使用时,需要传入一些常量参数,类似这样\r\n\r\napp.use(myPackage, {\r\n param1: xxxxx,\r\n params22: xxxx,\r\n});\n\n### Describe the solution you'd like\n\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.",[2923],{"name":2882,"color":2883},4354,"我的dependencies中某个依赖包需要在注册的时候传入参数,我该如何设置或者使用才能正确的传入参数呢?","2024-12-27T13:10:21Z","https://github.com/vuejs/vitepress/issues/4354",0.77078724,{"description":2930,"labels":2931,"number":2933,"owner":2868,"repository":2869,"state":2870,"title":2934,"updated_at":2935,"url":2936,"score":2937},"### Is your feature request related to a problem? Please describe.\r\n\r\nWe would like to have a way to easy navigate between home page and subpages.\r\n\r\n\r\n### Describe the solution you'd like\r\n\r\nNow, when we press on [Nav](https://vitepress.dev/reference/default-theme-nav) element it points to the home page. It would be useful to have a way to set a link to that element\r\n - Add `nav-link` to be used when you are on home page\r\n - Add `nav-sub-link` to be used when you are on subpage, and if not defined is equal to `nav-link`\r\n\r\nIn that way, we can easy navigate between home and subpages by press on same element. For example\r\n```javascript\r\nexport default {\r\n themeConfig: {\r\n nav: [\r\n { nav-link: '/markdown-examples'},\r\n { nav-sub-link: '/'},\r\n { text: 'Markdown Examples', link: '/markdown-examples' }\r\n ]\r\n }\r\n}\r\n```\r\n\r\n### Describe alternatives you've considered\r\n\r\nNo alternatives right now?\r\n\r\n### Additional context\r\n\r\nAnd example about how it works now\r\n\r\nhttps://github.com/user-attachments/assets/df4e051b-242c-4cbe-a3bd-8fa39ba25848\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] 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.",[2932],{"name":2882,"color":2883},4232,"Make Nav URL customisable for home page and subpages","2024-12-03T17:27:48Z","https://github.com/vuejs/vitepress/issues/4232",0.7712108,{"description":2939,"labels":2940,"number":2942,"owner":2868,"repository":2869,"state":2870,"title":2943,"updated_at":2944,"url":2945,"score":2946},"### Is your feature request related to a problem? Please describe.\r\n\r\nsuch as a vue components library site……\r\nA common problem for a documentation page is to show how to use a component, both in code and with demo of live component.\r\n\r\n### Describe the solution you'd like\r\n\r\nlike this [https://github.com/flingyp/vitepress-demo-preview](https://github.com/flingyp/vitepress-demo-preview)\r\n\r\n### Describe alternatives you've considered\r\n\r\n_No response_\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.",[2941],{"name":2882,"color":2883},3270,"Feature request: Vue component source code demo","2024-01-18T18:48:08Z","https://github.com/vuejs/vitepress/issues/3270",0.77202564,{"description":2948,"labels":2949,"number":2952,"owner":2868,"repository":2869,"state":2870,"title":2953,"updated_at":2954,"url":2955,"score":2956},"### 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.",[2950,2951],{"name":2879,"color":2880},{"name":2882,"color":2883},3763,"file name too long ","2025-03-02T18:09:25Z","https://github.com/vuejs/vitepress/issues/3763",0.77383083,{"description":2958,"labels":2959,"number":2961,"owner":2868,"repository":2869,"state":2870,"title":2962,"updated_at":2963,"url":2964,"score":2965},"### Is your feature request related to a problem? Please describe.\n\nI started using VitePress a long time ago, about 4 years back. I don't want to waste developers' time listening to me ramble, but the main reason I'm bringing this up is that I've accumulated a lot of notes. \r\n\r\nEvery time I publish a new note, I have to manually add the blog path in Sider, which is really inconvenient! I just want to write notes, and filling in the note path in Sider is a hassle for me. \r\n\r\nOf course, I noticed this issue: https://github.com/vuejs/vitepress/issues/572#issuecomment-1170116225\r\n\r\nBut it seems like it would require more work, which just adds to the burden of writing my notes!\n\n### Describe the solution you'd like\n\nI just want to happily take notes without worrying about file paths. I hope vitepress can intelligently analyze the note paths and stop making the note authors stress over this.\r\n\r\nFor example, if vitepress knows all the locations of my notes, then it should refresh the content of the sider and nav every time it builds.\r\n\r\nPlease don't overlook this issue. Thanks! \r\n\r\nThe number of notes users have keeps increasing over time, and users migrating from other frameworks face this problem even more. They need to manually fill in a lot of sider and nav, which raises their costs. \r\n\r\nPlease don't ignore this issue. Thank you!\n\n### Describe alternatives you've considered\n\nnull\n\n### Additional context\n\nnull\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.",[2960],{"name":2882,"color":2883},4229,"[feature] Request vitepress to automatically generate a sider from the file directory","2024-10-26T17:17:16Z","https://github.com/vuejs/vitepress/issues/4229",0.7768278,["Reactive",2967],{},["Set"],["ShallowReactive",2970],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fDUMMg_jFzbJMfj8iniJysuC6SadCqSGDrJxy7YF-Q-8":-1},"/vuejs/vitepress/3774"]