\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.",[3034,3037,3040],{"name":3035,"color":3036},"build","377ba8",{"name":3038,"color":3039},"has-workaround","1B4515",{"name":3021,"color":3022},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":3047,"labels":3048,"number":3051,"owner":3024,"repository":3025,"state":3026,"title":3052,"updated_at":3053,"url":3054,"score":3055},"### 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.",[3049,3050],{"name":3038,"color":3039},{"name":3021,"color":3022},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":3057,"labels":3058,"number":3060,"owner":3024,"repository":3025,"state":3061,"title":3062,"updated_at":3063,"url":3064,"score":3065},"### 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.",[3059],{"name":3035,"color":3036},1727,"closed","Allow disabling SSR","2023-01-31T00:04:44Z","https://github.com/vuejs/vitepress/issues/1727",0.7084535,{"description":3067,"labels":3068,"number":3069,"owner":3024,"repository":3025,"state":3061,"title":3070,"updated_at":3071,"url":3072,"score":3073},"### 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":3075,"labels":3076,"number":3077,"owner":3024,"repository":3025,"state":3061,"title":3078,"updated_at":3079,"url":3080,"score":3081},"### 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":3083,"labels":3084,"number":3088,"owner":3024,"repository":3025,"state":3061,"title":3089,"updated_at":3090,"url":3091,"score":3092},"### 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.",[3085],{"name":3086,"color":3087},"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":3094,"labels":3095,"number":3097,"owner":3024,"repository":3025,"state":3061,"title":3098,"updated_at":3099,"url":3100,"score":3101},"### 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.",[3096],{"name":3086,"color":3087},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":3103,"labels":3104,"number":3105,"owner":3024,"repository":3025,"state":3061,"title":3106,"updated_at":3107,"url":3108,"score":3109},"### 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":3111,"labels":3112,"number":3116,"owner":3024,"repository":3025,"state":3061,"title":3117,"updated_at":3118,"url":3119,"score":3120},"\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",[3113],{"name":3114,"color":3115},"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",3122],{},["Set"],["ShallowReactive",3125],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$f-k4_CPO8K7FXjSHN37oGpIvVrlyfaqcyG2gjltRW8HE":-1},"/vuejs/vitepress/2492"]