\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.",[2867,2870,2873],{"name":2868,"color":2869},"build","377ba8",{"name":2871,"color":2872},"has-workaround","1B4515",{"name":2874,"color":2875},"stale","ededed",4045,"vuejs","vitepress","open","SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.7348642,{"description":2885,"labels":2886,"number":2891,"owner":2877,"repository":2878,"state":2879,"title":2892,"updated_at":2893,"url":2894,"score":2895},"### Describe the bug\n\nI am trying to use the follwing HTML code to insert an image with a caption:\r\n```html\r\n\u003Cfigure style=\"text-align: center;\">\r\n \u003Cimg src=\"path/to/your/image.png\" alt=\"Description of the image\">\r\n \u003Cfigcaption>Caption describing the image\u003C/figcaption>\r\n\u003C/figure>\r\n```\r\nIf I run\r\n```bash\r\nnpm run docs:dev\r\n```\r\nit works well. However, I cannot build it, i.e., by\r\n```bash\r\nnpm run docs:build\r\n```\n\n### Reproduction\n\n1. Add the following in a markdown file\r\n\u003Cfigure style=\"text-align: center;\">\r\n \u003Cimg src=\"path/to/your/image.png\" alt=\"Description of the image\">\r\n \u003Cfigcaption>Caption describing the image\u003C/figcaption>\r\n\u003C/figure>\r\n2. build it by \"npm run docs:build\"\n\n### Expected behavior\n\nIt should insert an image with a caption.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 13.5.2\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 211.97 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.16.1 - /usr/local/bin/node\r\n npm: 9.5.1 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 119.0.6045.159\r\n Safari: 16.6\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.29 => 1.0.0-rc.29\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.",[2887,2890],{"name":2888,"color":2889},"need more info","bdbefc",{"name":2874,"color":2875},3262,"Why I cannot use html in markdown file to insert an image with caption?","2024-05-23T19:49:01Z","https://github.com/vuejs/vitepress/issues/3262",0.74759996,{"description":2897,"labels":2898,"number":2899,"owner":2877,"repository":2878,"state":2900,"title":2901,"updated_at":2902,"url":2903,"score":2904},"### Describe the bug\n\ndoesn’t work\r\n\r\nmy website link\r\nhttps://lark-base-team.github.io/js-sdk-docs/zh/start\r\nhere is my config\r\n```\r\nexport default defineConfig({\r\n lastUpdated: true,\r\n cleanUrls: true,\r\n base: '/js-sdk-docs/',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n },\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n // sitemap: {\r\n // hostname: 'https://basejsapi.com',\r\n // },\r\n lang: 'zh',\r\n locales: {\r\n zh: {\r\n label: '中文',\r\n lang: 'zh',\r\n dir: '/zh',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n sidebar: getZhSideBar(),\r\n },\r\n },\r\n en: {\r\n label: 'English',\r\n lang: 'en',\r\n dir: '/en',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n logo: '/logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n head: [\r\n ['link', { rel: 'icon', href: '/logo.svg' }],\r\n ],\r\n nav: [\r\n { text: 'API', link: '/en/api/guide.md' },\r\n ],\r\n sidebar: getEnSideBar(),\r\n },\r\n }\r\n },\r\n})\r\n\r\n```\n\n### Reproduction\n\n vitepress: 1.0.0-rc.10 \n\n### Expected behavior\n\nshould dispaly the icon in tab\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 13.6\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 53.27 MB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.14.2 - ~/.nvm/versions/node/v18.14.2/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 9.5.0 - ~/.nvm/versions/node/v18.14.2/bin/npm\r\n pnpm: 8.7.4 - ~/.nvm/versions/node/v18.14.2/bin/pnpm\r\n Browsers:\r\n Chrome: 117.0.5938.149\r\n Safari: 16.6\r\n npmPackages:\r\n vitepress: 1.0.0-rc.10 => 1.0.0-rc.10\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.",[],3075,"closed","After doing internationalization configuration, the tab icon on the browser page does not take effect.","2023-10-21T00:05:55Z","https://github.com/vuejs/vitepress/issues/3075",0.72796714,{"description":2906,"labels":2907,"number":2911,"owner":2877,"repository":2878,"state":2900,"title":2912,"updated_at":2913,"url":2914,"score":2915},"\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\nCan't use `img` tag in `v0.7.1` (works in `v0.7.0`).\r\n\r\n**To Reproduce**\r\n\r\n1.\r\n```sh\r\nnpm init\r\nyarn add vitepress\r\nwget -O vue.png https://upload.wikimedia.org/wikipedia/commons/thumb/9/95/Vue.js_Logo_2.svg/220px-Vue.js_Logo_2.svg.png\r\necho '' > index.md\r\n```\r\n\r\n2. `npx vitepress` – image will work in development\r\n\r\n\r\n3. `npx vitepress build`\r\n* build will fail due to https://github.com/vitejs/vite/pull/992\r\n* but even with that fix, the build will strip out `src` attribute of `img` and no image will be loaded\r\n\r\n**Expected behavior**\r\nImages should be preserved in build.\r\n\r\n**System Info**\r\n- vitepress version: 0.7.1\r\n- vite version: 1.0.0-rc.8\r\n- Node version: 15.0.1\r\n- OS version: macOS 10.16.7\r\n\r\n**Additional context**\r\n\r\nUsing an absolute URL works as expected in dev and build.\r\n",[2908],{"name":2909,"color":2910},"bug: pending triage","e99695",113,"Local images stripped out in build","2023-01-21T16:24:20Z","https://github.com/vuejs/vitepress/issues/113",0.72848135,{"description":2917,"labels":2918,"number":2920,"owner":2877,"repository":2878,"state":2900,"title":2921,"updated_at":2922,"url":2923,"score":2924},"### 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.",[2919],{"name":2874,"color":2875},826,"support adding attributes to code blocks","2023-08-11T00:04:28Z","https://github.com/vuejs/vitepress/issues/826",0.7295251,{"description":2926,"labels":2927,"number":2928,"owner":2877,"repository":2878,"state":2900,"title":2929,"updated_at":2930,"url":2931,"score":2932},"### 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.73202175,{"description":2934,"labels":2935,"number":2939,"owner":2877,"repository":2878,"state":2900,"title":2940,"updated_at":2941,"url":2942,"score":2943},"### Describe the bug\n\nWhen the default theme is used, when the sidebar configuration is greater than or equal to four layers, the navigation menu title style of the content md file parsing is missing\r\n\r\n\n\n### Reproduction\n\n\r\n![Uploading image.png…]()\r\n\n\n### Expected behavior\n\nRegardless of whether the parsed style of several layers of content is correct, or the level is configurable\n\n### System Info\n\n```shell\nvitepress:0.19.2\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[2936],{"name":2937,"color":2938},"theme","0754FB",409,"When the sidebar configuration exceeds four levels, the title style generated by parsing the content is missing","2023-01-21T16:04:06Z","https://github.com/vuejs/vitepress/issues/409",0.7330318,{"description":2945,"labels":2946,"number":2948,"owner":2877,"repository":2878,"state":2900,"title":2949,"updated_at":2950,"url":2951,"score":2952},"### Is your feature request related to a problem? Please describe.\r\n\r\nThere is no easy way to have captions for images.\r\n\r\n### Describe the solution you'd like\r\n\r\nAny image I'm adding as `{.image}` should have the caption be generated as \"Text here\" in the `\u003Cfigcaption>` element below the image. The entire thing should be in a `\u003Cfigure>` element and either the `\u003Cimg>` or `\u003Cfigure>` should have `class=\"image\"`.\r\n\r\nSo basically,\r\n```markdown\r\n{.image}\r\n```\r\nshould generate\r\n```html\r\n\u003Cfigure>\r\n \u003Cimg class=\"image\" src=\"/path/to/image/\" alt=\"Alt text here\">\r\n \u003Cfigcaption>Text here\u003C/figcaption>\r\n\u003C/figure>\r\n```\r\nThis would allow to link to licenses and provide attribution to image sources. \r\n\r\n\r\n### Describe alternatives you've considered\r\n\r\nI've tried using [`markdown-it-image-caption`](https://www.npmjs.com/package/markdown-it-image-caption), [`markdown-it-figure-caption`](https://www.npmjs.com/package/markdown-it-figure-caption) and [`mdfigcaption`](https://www.npmjs.com/package/mdfigcaption), but none were suitable for me.\r\n\r\nThe issue I'm having with all of these is that they're not letting me add my own classes to the `\u003Cfigure>` element, so I can't theme each image individually. This is an issue since the images I'm using need to be of different sizes depending on where they are in the text, which classes allow me to do.\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.",[2947],{"name":2868,"color":2869},892,"Image captions","2023-01-21T14:32:51Z","https://github.com/vuejs/vitepress/issues/892",0.7334487,{"description":2954,"labels":2955,"number":2957,"owner":2877,"repository":2878,"state":2900,"title":2958,"updated_at":2959,"url":2960,"score":2961},"### Describe the bug\n\nHello, awesome effort, looking forward to how this project grows.\r\n\r\nContext: adding documentation with Vitepress to a vue3 library that uses aliases inside `/@`. \r\n\r\nAdded `resolve.alias` using a `vite.config.ts` based on this https://github.com/vuejs/vitepress/issues/241 \r\n\r\nIt worked, but suddenly ignored completely the config on `docs/.vitepress/config.ts` (title, sidebar, nav, etc)\r\n\r\n```js\r\n// docs/.vitepress/config.ts\r\n\r\nmodule.exports = {\r\n title: 'Vue Dynamic Forms',\r\n description,\r\n themeConfig: {\r\n repo: 'asigloo/vue-dynamic-forms',\r\n logo: '/logo.svg',\r\n nav: [\r\n {\r\n text: 'Migration Guide',\r\n link: '/v3/guide/migration-guide',\r\n },\r\n ],\r\n sidebar: {\r\n '/': [\r\n {\r\n text: 'Guide',\r\n children: [\r\n {\r\n text: 'Introduction',\r\n link: '/guide/',\r\n },\r\n {\r\n text: 'Getting Started',\r\n link: '/guide/getting-started',\r\n },\r\n {\r\n text: 'Usage',\r\n link: '/guide/usage',\r\n },\r\n ],\r\n },\r\n ],\r\n },\r\n },\r\n}\r\n\r\n```\r\n\r\n\r\n\n\n### Reproduction\n\n- Add a `vite.config.ts` inside `docs` root \r\n- Add a `title`, also add `themeConfig`, `nav` or `sidebar` on `docs/.vitepress/config.ts` \r\n- Run `vitepress dev docs` \n\n### Expected behavior\n\n`vite.config.ts` `docs/.vitepress/config.ts` configs can live together \r\n\r\nor\r\n\r\nAn option to add `alias` to `docs/.vitepress/config.ts` \n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 11.4\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9980HK CPU @ 2.40GHz\r\n Memory: 544.29 MB / 16.00 GB\r\n Shell: 5.8 - /bin/zsh\r\n Binaries:\r\n Node: 16.3.0 - ~/.nvm/versions/node/v16.3.0/bin/node\r\n Yarn: 1.22.10 - /usr/local/bin/yarn\r\n npm: 7.19.1 - ~/Projects/github/vue-dynamic-forms/node_modules/.bin/npm\r\n Browsers:\r\n Chrome: 92.0.4515.159\r\n Firefox: 89.0.1\r\n Safari: 14.1.1\r\n npmPackages:\r\n vitepress: ^0.16.1 => 0.15.6 \r\n```\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[2956],{"name":2909,"color":2910},373,"ThemeConfig is ignored when using vite.config.ts inside docs","2023-01-21T14:32:46Z","https://github.com/vuejs/vitepress/issues/373",0.73354053,{"description":2963,"labels":2964,"number":2966,"owner":2877,"repository":2878,"state":2900,"title":2967,"updated_at":2968,"url":2969,"score":2970},"### Is your feature request related to a problem? Please describe.\n\nhttps://v2.vuepress.vuejs.org/reference/default-theme/components.html\r\n\r\nthis component comes handy when presenting something with a distinct label, say, a version. Please please have it in vitepress.\r\n\u003Cimg width=\"291\" alt=\"Screenshot 2022-08-11 at 3 35 48 PM\" src=\"https://user-images.githubusercontent.com/1858427/184085656-67b87e05-ec0f-4b9b-ade3-0395a0f9e275.png\">\r\n\r\n\n\n### Describe the solution you'd like\n\nto have a built-in badge feature\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.vuejs.org).\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.",[2965],{"name":2937,"color":2938},1156,"Badge feature ","2023-01-21T14:22:48Z","https://github.com/vuejs/vitepress/issues/1156",0.7336825,["Reactive",2972],{},["Set"],["ShallowReactive",2975],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$ftncqsE0q7faVqSQOeGE7JD6eA1CJtYuKaHGveqhBclQ":-1},"/vuejs/vitepress/1309"]