\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.",[3040,3043,3046],{"name":3041,"color":3042},"build","377ba8",{"name":3044,"color":3045},"has-workaround","1B4515",{"name":3027,"color":3028},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.74055624,{"description":3053,"labels":3054,"number":3055,"owner":3030,"repository":3031,"state":3032,"title":3056,"updated_at":3057,"url":3058,"score":3059},"### Is your feature request related to a problem? Please describe.\n\nWith a browser with a classic scrollbar (non-overlay scrollbar), layout shifts happens when navigating between pages with/without scrollbars.\n\nhttps://github.com/user-attachments/assets/bce34ead-ff10-4248-9a98-76b93a70e437\n\nIt'd be nice if these layout shifts can be avoided.\n\n\n### Describe the solution you'd like\n\nUsing the [`scrollbar-gutter`](https://developer.mozilla.org/en-US/docs/Web/CSS/scrollbar-gutter) property may work.\nIt didn't work for my site as the background of the space reserved by the property isn't able to be configured ([the change I ended up with](https://github.com/sapphi-red/portfolio/commit/d50406dc04847e21da4586b98cb1c1a66a39c0bb)).\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.",[],4877,"Reduce layout shifts with classic scrollbars","2025-08-02T09:51:45Z","https://github.com/vuejs/vitepress/issues/4877",0.7494009,{"description":3061,"labels":3062,"number":3064,"owner":3030,"repository":3031,"state":3065,"title":3066,"updated_at":3067,"url":3068,"score":3069},"### Describe the bug\n\n知乎热搜榜不更新\n这是itab 知乎\n\n\u003Cimg width=\"1579\" height=\"903\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/7604efd0-49a5-495c-9fd6-8d24549f2e27\" />\n这是知乎网站的热搜榜\n\n\u003Cimg width=\"807\" height=\"942\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/092b0749-e7d2-4b00-bd5b-172b6725c892\" />\n\n### Reproduction\n\n希望能更新接口,获取最新热搜数据\n\n### Expected behavior\n\n希望能更新接口,获取最新热搜数据\n\n### System Info\n\n```Text\n1.6.20\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.",[3063],{"name":3024,"color":3025},4866,"closed","知乎热搜榜不更新","2025-07-30T04:05:01Z","https://github.com/vuejs/vitepress/issues/4866",0.6925816,{"description":3071,"labels":3072,"number":3074,"owner":3030,"repository":3031,"state":3065,"title":3075,"updated_at":3076,"url":3077,"score":3078},"### Describe the bug\r\n\r\nhttps://github.com/vuejs/vitepress/blob/75ca9e4302c65e3bcc9518f7df928318380f6cf6/src/node/markdown/plugins/highlightLines.ts#L30\r\n\r\n`highlightLinePlugin` is used before `attrs`, and `token.info` is rewritten.\r\n\r\nvia https://github.com/vuejs/vitepress/pull/664#discussion_r902203459\r\n\r\n### Reproduction\r\n\r\n\u003Cimg width=\"177\" alt=\"image\" src=\"https://user-images.githubusercontent.com/8336744/174726207-1c068f94-f597-4d5e-9101-4709a08a60c3.png\">\r\n\r\n\u003Cimg width=\"299\" alt=\"image\" src=\"https://user-images.githubusercontent.com/8336744/174726233-83967c42-db47-4c12-8dbd-0c83a817c448.png\">\r\n\r\n\r\n### Expected behavior\r\n\r\nRender `data=\"asdf\"`\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.0\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 13.84 GB / 64.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.1 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/node\r\n Yarn: 1.22.19 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/yarn\r\n npm: 8.12.1 - ~/Library/Caches/fnm_multishells/95455_1655742557079/bin/npm\r\n Browsers:\r\n Chrome: 102.0.5005.115\r\n Firefox: 101.0.1\r\n Safari: 16.0\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.2 => 1.0.0-alpha.2\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.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3073],{"name":3027,"color":3028},826,"support adding attributes to code blocks","2023-08-11T00:04:28Z","https://github.com/vuejs/vitepress/issues/826",0.7099128,{"description":3080,"labels":3081,"number":3085,"owner":3030,"repository":3031,"state":3065,"title":3086,"updated_at":3087,"url":3088,"score":3089},"### Describe the bug\n\nWhen using \r\n```\r\nthemeConfig: {\r\n\t\tlogo: '/logo-Wikimedia.svg'\r\n}\r\n```\r\nthe `img` output doesn't feature an `alt` attribute required for screenreaders. \r\nEither a duplication of the title or better a required `logoAlt` key would be useful.\n\n### Reproduction\n\nGo to https://doc.wikimedia.org/codex/main/ and inspect the source:\r\n`\u003Cimg class=\"VPImage logo\" src=\"/codex/main/logo-Wikimedia.svg\" data-v-d5fed348=\"\">`\n\n### Expected behavior\n\n`img` tags need to feature an `alt` attribute to be valid HTML. Starting with an empty one and providing an option to define the value would be necessary.\n\n### System Info\n\n```shell\nVitePress 1.0.0-alpha.10\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.",[3082],{"name":3083,"color":3084},"docs","0075ca",1309,"themeConfig logo option results in an `img` output without `alt` attribute","2023-01-21T14:25:29Z","https://github.com/vuejs/vitepress/issues/1309",0.72297233,{"description":3091,"labels":3092,"number":3094,"owner":3030,"repository":3031,"state":3065,"title":3095,"updated_at":3096,"url":3097,"score":3098},"### Describe the bug\r\n\r\nFor example the page https://blog.jaggerwang.net/basicai-annotation-specification/ cannot access directly, but it's ok when add `index.html` suffix, and other pages did not have this problem, such as https://blog.jaggerwang.net/basicai-technical-architecture/ . So it seems related to the content of page?\r\n\r\n\u003Cimg width=\"1512\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/1255011/3a69f282-d002-4194-b7ca-3b3075616883\">\r\n\r\nIt's ok when running in local dev and preview mode, and there is no error showing in the browser console or terminal console.\r\n\r\n\u003Cimg width=\"1512\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/1255011/82b87b50-f21a-430e-bb4e-893eb3bf9c52\">\r\n\r\n### Reproduction\r\n\r\nProject structure:\r\n\r\n\u003Cimg width=\"1624\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/1255011/d3f2d9e0-5dc8-4344-9674-61433c5a8322\">\r\n\r\nAliyun OSS config:\r\n\r\n\u003Cimg width=\"1306\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/1255011/d30acd18-d20c-44f2-a872-61bd981d0bcb\">\r\n\r\nBuid with GitHub actions, but the html is same with local build.\r\n\r\n\u003Cimg width=\"1624\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/1255011/f57bef3c-2d76-47c4-b18a-4b4a7b696771\">\r\n\r\n### Expected behavior\r\n\r\nNo error.\r\n\r\n### System Info\r\n\r\n```Text\r\nAliyun OSS\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.",[3093],{"name":3024,"color":3025},3322,"Refresh some pages with error \"Hydration completed but contains mismatches.\" when deployed on Aliyun OSS.","2023-12-21T00:04:35Z","https://github.com/vuejs/vitepress/issues/3322",0.7251732,{"description":3100,"labels":3101,"number":3102,"owner":3030,"repository":3031,"state":3065,"title":3103,"updated_at":3104,"url":3105,"score":3106},"### Describe the bug\n\nThe typical behaviour on GitHub or in vuepress is:\r\n\r\n\r\n\r\nThe behaviour in vitepress is different:\r\n\r\n\r\n\r\n\r\n\n\n### Reproduction\n\nThe source markdown:\r\n\r\n```\r\nПроизводство энергии на начальном этапе игры заключаются в строительстве достаточного количества бойлеров ** `Boiler`, паровых двигателей ** `Steam engine` и снабжение их углём ** `Coal`, не забывая при этом про насосы ** `Offshore pump` подающие воду ** `Water` в бойлеры из ближайших луж. По мере возможностей и без особого спеха производим солнечные панели ** `Solar panel` и устанавливаем их в пустых участках разрастающейся базы. На аккумуляторы  `Accumulator` можно забить до поры до времени, когда ресурсов будет хватать на большее.\r\n```\n\n### Expected behavior\n\nsomethere, vitepress marked all images with css style like\r\n\r\n```\r\ndisplay: block;\r\n```\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (6) x64 Intel(R) Core(TM) i5-9400 CPU @ 2.90GHz\r\n Memory: 8.34 GB / 15.92 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.91)\r\n Internet Explorer: 11.0.19041.3636\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.32 => 1.0.0-rc.34\n```\n\n\n### Additional context\n\nAlso, I found out that vitepress does not integrate small images as `\u003Cimg src=\"data:image/png;base64,...`\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.",[],3397,"small images are not integrated into the text ","2024-01-09T00:05:13Z","https://github.com/vuejs/vitepress/issues/3397",0.73230606,{"description":3108,"labels":3109,"number":3111,"owner":3030,"repository":3031,"state":3065,"title":3112,"updated_at":3113,"url":3114,"score":3115},"### Describe the bug\n\nThe VPHero image does only set the 'max-width' inside the media querys but not 'max-height'.\r\nThis leads to an overlap of the hero image and the content that follows it.\r\n\r\nhttps://pinia.vuejs.org/ had the same problem with its hero image, beeing 214px in width and 320px in height.\r\nThey solved it by adding `max-height` to their custom css.\r\n\r\n```css\r\n@media (min-width: 960px)\r\n.VPHero .VPImage.image-src {\r\n max-height: 320px;\r\n}\r\n@media (min-width: 640px)\r\n.VPHero .VPImage.image-src {\r\n max-height: 256px;\r\n}\r\n.VPHero .VPImage.image-src {\r\n max-height: 192px;\r\n}\r\n@media (min-width: 960px)\r\n[data-v-be2bd16f] .image-src {\r\n max-width: 320px;\r\n}\r\n@media (min-width: 640px)\r\n[data-v-be2bd16f] .image-src {\r\n max-width: 256px;\r\n}\r\n```\r\nThe better solution would be to just add it to the VPHero component.\r\n\r\n\r\n\n\n### Reproduction\n\nTake an image which is not cubical, so has more height than width and set it as hero image\r\n\r\n```markdown\r\n---\r\nlayout: home\r\n\r\nhero:\r\n image:\r\n src: /assets/\u003Cimage-name>.svg\r\n alt: alt-text\r\n```\n\n### Expected behavior\n\nThe VPHero image height should scale like the width.\r\n\r\n\r\n\r\n\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (32) x64 AMD Ryzen 9 3950X 16-Core Processor\r\n Memory: 36.46 GB / 127.82 GB\r\n Binaries:\r\n Node: 16.14.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.7.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.50) \r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.13 => 1.0.0-alpha.47\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.",[3110],{"name":3024,"color":3025},1982,"VPHero image height does not scale for small viewports","2023-03-05T00:04:55Z","https://github.com/vuejs/vitepress/issues/1982",0.7358723,{"description":3117,"labels":3118,"number":3119,"owner":3030,"repository":3031,"state":3065,"title":3120,"updated_at":3121,"url":3122,"score":3123},"### Is your feature request related to a problem? Please describe.\n\nIn the content rendered by markdown, whether the image can support the click pop-up window to display the original size of the image\n\n### Describe the solution you'd like\n\nSupports mouse wheel zooming in and out\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.",[],3612,"whether the image can support the click pop-up window to display the original size of the image","2024-03-07T00:03:36Z","https://github.com/vuejs/vitepress/issues/3612",0.736744,["Reactive",3125],{},["Set"],["ShallowReactive",3128],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fBKP4Cbx0qkDj8dBDB4eW9wdYImqhnlvPjtgpEfqUOG8":-1},"/vuejs/vitepress/4853"]