\r\n title: Feature A\r\n details: Lorem ipsum dolor sit amet, consectetur adipiscing elit\r\n```\r\n\r\nCheck the feature icon type\r\n```ts\r\ntype FeatureIcon =\r\n | string\r\n | { src: string; alt?: string; width?: string; height: string }\r\n | {\r\n light: string\r\n dark: string\r\n alt?: string\r\n width?: string\r\n height: string\r\n }\r\n```\r\n\r\nI refer to the render logic, use `v-html` render the icon.\r\nDisplay well in `dev` environment, but shows errors in `prod` environment.\r\n\r\n| dev | build |\r\n| ----------- | ----------- |\r\n|  |  |\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/github/zyyv/vitepress-unocss-issue\r\n\r\n- Display right run `pnpm dev`\r\n- Display error run `pnpm build && pnpm preview`\r\n\r\n### Expected behavior\r\n\r\nDev and build behave the same\r\n\r\n### System Info\r\n\r\n```Text\r\nlatest\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.",[2870,2873,2876],{"name":2871,"color":2872},"build","377ba8",{"name":2874,"color":2875},"has-workaround","1B4515",{"name":2857,"color":2858},4045,"SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.73971224,{"description":2883,"labels":2884,"number":2887,"owner":2860,"repository":2861,"state":2862,"title":2888,"updated_at":2889,"url":2890,"score":2891},"### Is your feature request related to a problem? Please describe.\n\nI noticed that the search bar by default is pretty bad compared to the one in mkdocs, at least for me\r\n\n\n### Describe the solution you'd like\n\nadd lunr.js which has proven to be very good in conjunction with mkdocs and you hardly need to configure it extensively to get a good result\r\nhttps://github.com/olivernn/lunr.js\n\n### Describe alternatives you've considered\n\nimprove default search\n\n### Additional context\n\nVitepress:\r\nthe desired result always appears last\r\n\r\n\r\nMkDocs:\r\n\r\n\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.",[2885,2886],{"name":2874,"color":2875},{"name":2857,"color":2858},3429,"Add lunr.js as one of the available plugins for Search","2024-03-07T11:19:10Z","https://github.com/vuejs/vitepress/issues/3429",0.7469823,{"description":2893,"labels":2894,"number":2896,"owner":2860,"repository":2861,"state":2897,"title":2898,"updated_at":2899,"url":2900,"score":2901},"### Is your feature request related to a problem? Please describe.\r\n\r\n- 自定义vue组件库,会用到很多第三方插件,比如:[@wangeditor/editor](https://github.com/nikitasnv/vue-resizable),[vue-resizable](https://github.com/wangeditor-team/wangEditor)等,而这些插件,都会用到window,document等这些变量\r\n\r\n- 当使用 vitepress 构建组件库文档时,`pnpm run build`,就会报错:\r\n```\r\nbuild error:\r\nReferenceError: document is not defined\r\n```\r\n\r\n- 如果都去让第三方插件作者去修改代码,这样也有点不切实际\r\n\r\n\r\n### Describe the solution you'd like\r\n\r\n- vitepress build的时候,能否可以配置关闭SSR?或者有没有别的办法可以解决上述报错?非常感谢\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.vuejs.org).\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.",[2895],{"name":2871,"color":2872},1727,"closed","Allow disabling SSR","2023-01-31T00:04:44Z","https://github.com/vuejs/vitepress/issues/1727",0.7084535,{"description":2903,"labels":2904,"number":2905,"owner":2860,"repository":2861,"state":2897,"title":2906,"updated_at":2907,"url":2908,"score":2909},"### Is your feature request related to a problem? Please describe.\r\n\r\nI'd like the ability to ignore certain markdown files in the project directory to be considered a page.\r\n\r\nFor example, in a GitHub repository hosting a Vitepress site, the `README.md` file is unlikely to be intended to be a page but is necessary for the docs for the repository.\r\n\r\n\r\n### Describe the solution you'd like\r\n\r\nConfig file property called `ignoreFiles` where I can pass in array of strings (eg. globs) and regular expressions.\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.vuejs.org).\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.",[],584,"Ignore specific markdown files","2023-01-21T16:20:01Z","https://github.com/vuejs/vitepress/issues/584",0.7131262,{"description":2911,"labels":2912,"number":2913,"owner":2860,"repository":2861,"state":2897,"title":2914,"updated_at":2915,"url":2916,"score":2917},"### Is your feature request related to a problem? Please describe.\r\n\r\nI tried to use VitePress to build my blog, but I notice that `frontmatter.draft` is not supported.I don't think add support for `frontmatter.draft` is a good solution, because we can't directly know the post is draft or not.\r\n\r\nI defined `$draft \u003Cpost-title>.md` as my post file name, and noticed that I can overwrite the path generation but can't ignore the path generation for the specified file.\r\n\r\n### Describe the solution you'd like\r\n\r\nadd `ignore` option for `config.ts` file, like:\r\n\r\n```ts\r\n{\r\n ignore: (path: string) => path === \"\u003Cpath-to-be-ignored>\"\r\n}\r\n```\r\n\r\n```ts\r\n{\r\n ignore: (path: string) => /^\\$draft */.test(path.split(\"/\").at(-1))\r\n}\r\n```\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.",[],3255,"Support ignoring the specified path generation","2023-12-04T00:04:55Z","https://github.com/vuejs/vitepress/issues/3255",0.72569746,{"description":2919,"labels":2920,"number":2924,"owner":2860,"repository":2861,"state":2897,"title":2925,"updated_at":2926,"url":2927,"score":2928},"### Describe the bug\n\n\r\n\r\nhttps://github.com/vuejs/vitepress/blob/9004a801305fa0c21a0064253da95fbad38148fe/src/client/app/utils.ts#L38\r\n\r\nby \r\n\r\nhttps://github.com/vuejs/vitepress/blob/89cc718649b9be547c6ec08d2dc3d10a67f2a3ac/src/client/app/utils.ts#L38-L39\r\n\r\nshould fix this.\r\n\r\n_Originally posted by @brc-dd in https://github.com/vuejs/vitepress/issues/412#issuecomment-1149704365_\r\n \r\n\r\nI still have this problem\r\n\r\nvitepress version:1.0.0-alpha.26 or npm:@brc-dd/vitepress@1.0.0-dev.50d1202\r\n\r\nI try to configure `cleanUrls: 'with-subfolders'` or `cleanUrls:' without-subfolders'` or delete the cleanUrls configuration item makes no difference or is still reporting an error\r\n\r\nI will temporarily open my [repo](https://github.com/you-hengh/myblog_vitepress) to find bugs.\n\n### Reproduction\n\npackage.json\r\n```json\r\n{\r\n \"name\": \"vitepress\",\r\n \"version\": \"1.0.0\",\r\n \"description\": \"\",\r\n \"main\": \"index.js\",\r\n \"scripts\": {\r\n \"dev\": \"vitepress dev docs\",\r\n \"build\": \"vitepress build docs\",\r\n \"serve\": \"vitepress serve docs\"\r\n },\r\n \"keywords\": [],\r\n \"author\": \"\",\r\n \"license\": \"ISC\",\r\n \"devDependencies\": {\r\n \"@algolia/client-search\": \"^4.14.2\",\r\n \"vitepress\": \"npm:@brc-dd/vitepress@1.0.0-dev.50d1202\"\r\n }\r\n}\r\n```\r\n\r\n1. pnpm build\r\n\r\n ```bash\r\n > vitepress build docs\r\n\r\n vitepress v1.0.0-dev.50d1202\r\n ✓ building client + server bundles...\r\n ⠋ rendering pages...[Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n [Vue warn]: Component \u003CAnonymous> is missing template or render function.\r\n ✓ rendering pages...\r\n build complete in 3.35s.\r\n ```\r\n\r\n2. pnpm serve\r\n\r\n ```bash\r\n > vitepress@1.0.0 serve /Users/bddxg/Documents/网站/vitepress 站点\r\n > vitepress serve docs\r\n\r\n vitepress v1.0.0-dev.50d1202\r\n Built site served at http://localhost:4173/\r\n ```\r\n\r\n\n\n### Expected behavior\n\nfix bug or tell me the solution.\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 13.0\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 5.11 GB / 32.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.17.1 - ~/Library/pnpm/node\r\n npm: 8.15.0 - ~/Library/pnpm/npm\r\n Browsers:\r\n Chrome: 106.0.5249.119\r\n Safari: 16.1\r\n npmPackages:\r\n @brc-dd/vitepress: 1.0.0-dev.50d1202\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.",[2921],{"name":2922,"color":2923},"bug: pending triage","e99695",1578,"vitepress serve tries to load an md.undefined.js file","2023-01-21T14:20:50Z","https://github.com/vuejs/vitepress/issues/1578",0.73263264,{"description":2930,"labels":2931,"number":2933,"owner":2860,"repository":2861,"state":2897,"title":2934,"updated_at":2935,"url":2936,"score":2937},"### Describe the bug\n\nWhen `/docs/index.md` is missing while `/public/index.html` is present (with all the default configs) and navigating to site root, 404 error is thrown.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-vqzpel?file=docs%2Fpublic%2Findex.html \n\n### Expected behavior\n\n`/public/index.html` static html should be served instead instead of 404 (VuePress worked this way). Alternatively, there should be a way to configure custom static HTML home page w/o the need to use server-side config (as it's not always possible, eg on github pages).\n\n### System Info\n\n```sh\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (16) x64 Intel(R) Core(TM) i7-6900K CPU @ 3.20GHz\r\n Memory: 45.66 GB / 63.92 GB\r\n Binaries:\r\n Node: 18.2.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.5 - C:\\Program Files (x86)\\Yarn\\bin\\yarn.CMD\r\n npm: 9.6.6 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 113.0.5672.127\r\n Edge: Spartan (44.19041.1266.0), Chromium (113.0.1774.50)\r\n npmPackages:\r\n vitepress: ^1.0.0-beta.1 => 1.0.0-beta.1\r\n```\n```\n\n\n### Additional context\n\nRelated discussion thread: https://github.com/vuejs/vitepress/discussions/2425\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.",[2932],{"name":2922,"color":2923},2426,"/public/index.html is not served when /docs/index.md is missing","2023-06-04T00:04:30Z","https://github.com/vuejs/vitepress/issues/2426",0.7427182,{"description":2939,"labels":2940,"number":2941,"owner":2860,"repository":2861,"state":2897,"title":2942,"updated_at":2943,"url":2944,"score":2945},"### Is your feature request related to a problem? Please describe.\n\n当我在文档里插入图片发布后,图片中有部分内容在页面上较为模糊。我试过markdown-it-custom-attrs插件,但是好像没有生效。\n\n### Describe the solution you'd like\n\n在vitepress中集成图片灯箱的功能,或者有什么办法可以集成相关组件(希望给一个示例)\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.",[],2674,"能否增加一个图片点击放大的功能。","2023-08-01T00:04:35Z","https://github.com/vuejs/vitepress/issues/2674",0.7430976,{"description":2947,"labels":2948,"number":2952,"owner":2860,"repository":2861,"state":2897,"title":2953,"updated_at":2954,"url":2955,"score":2956},"\u003C!--\r\nNOTE:\r\nVitePress is still WIP, and it is not compatible with VuePress.\r\nPlease do not open issue about default theme missing features or something doesn't work like VuePress.\r\n-->\r\n\r\n**Describe the bug**\r\n\r\nAdding a simple directive inside a markdown file or an SFC throws an error during the build. Seems like ClientOnly component does not exist yet in VitePress.\r\n\r\n`Custom directive is missing corresponding SSR transform and will be ignored.`\r\n\r\n**To Reproduce**\r\n\r\n\r\n```\r\n\u003Cdiv v-test>test\u003C/div>\r\n\r\n\r\n\u003Cscript>\r\nexport default {\r\n directives: {\r\n test: {\r\n mounted(el, binding) {\r\n console.log(el)\r\n }\r\n }\r\n }\r\n}\r\n\u003C/script>\r\n```\r\n\r\n\r\n**Expected behavior**\r\nBuild should work even though an SSR implementation for the custom directive doesn't exist.\r\n\r\n**System Info**\r\n- vitepress version: 0.6.0\r\n- vite version: v1.0.0-rc.4\r\n- Node version: 12.18.3\r\n- OS version: Catalina 10.15.6\r\n\r\n**Additional context**\r\nNone.\r\n",[2949],{"name":2950,"color":2951},"docs","0075ca",92,"Build fails due to custom directive missing an SSR Transform","2023-01-21T14:26:34Z","https://github.com/vuejs/vitepress/issues/92",0.7448973,["Reactive",2958],{},["Set"],["ShallowReactive",2961],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$f-k4_CPO8K7FXjSHN37oGpIvVrlyfaqcyG2gjltRW8HE":-1},"/vuejs/vitepress/2492"]