\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.",[3165,3168,3171],{"name":3166,"color":3167},"build","377ba8",{"name":3169,"color":3170},"has-workaround","1B4515",{"name":3172,"color":3173},"stale","ededed",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.7255671,{"description":3180,"labels":3181,"number":3183,"owner":3155,"repository":3156,"state":3157,"title":3184,"updated_at":3185,"url":3186,"score":3187},"### Describe the bug\n\n我尝试在项目构建时,生成rss文件。使用createMarkdownRenderer函数来渲染文章内容,传了一些md配置,但是并没有生效。\n\n\n\n### Reproduction\n\n1. 在 docs/.vitepress/config/index.ts 配置中的 buildEnd 方法里调用生成rss的函数\n2. 生成rss的函数里调用createMarkdownRenderer渲染文章,并传入md配置\n3. 渲染完成生成rss文件后,md的配置并没有生效\n\n### Expected behavior\n\n预期createMarkdownRenderer函数的参数生效\n\n### System Info\n\n```Text\nSystem:\n OS: macOS 15.4.1\n CPU: (10) arm64 Apple M4\n Memory: 98.05 MB / 16.00 GB\n Shell: 5.9 - /bin/zsh\n Binaries:\n Node: 20.18.0 - ~/.nvm/versions/node/v20.18.0/bin/node\n npm: 11.2.0 - ~/.nvm/versions/node/v20.18.0/bin/npm\n pnpm: 9.14.2 - ~/.nvm/versions/node/v20.18.0/bin/pnpm\n Browsers:\n Chrome: 135.0.7049.115\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.",[3182],{"name":3152,"color":3153},4725,"createMarkdownRenderer的参数未生效","2025-04-28T03:14:10Z","https://github.com/vuejs/vitepress/issues/4725",0.729261,{"description":3189,"labels":3190,"number":3191,"owner":3155,"repository":3156,"state":3192,"title":3193,"updated_at":3194,"url":3195,"score":3196},"### Describe the bug\n\nAdding `[[toc]]` generates `div` inside `p` element and causes a hydration mismatch\n\n### Reproduction\n\n```md\r\n\r\n---\r\ntitle: Testing\r\n---\r\n\r\n[[toc]]\r\n\r\n## Test 1\r\n\r\ntest\r\n\r\n## Test 2\r\n\r\ntest\r\n\r\n```\r\nthis generates:\r\n```html\r\n...\r\n\u003Cp>\r\n\u003Cdiv class=\"table-of-contents\">\u003Cul>\u003Cli>\u003Ca href=\"#test-1\">Test 1\u003C/a>\u003C/li>\u003Cli>\u003Ca href=\"#test-2\">Test 2\u003C/a>\u003C/li>\u003C/ul>\u003C/div>\r\n\u003C/p>\r\n...\r\n```\r\nand a `div` element cannot be inside a `p` element so it causes a hydration mismatch when directly visiting the page\n\n### Expected behavior\n\nthe `div` should not be inside the `p`\n\n### System Info\n\n```shell\nSystem:\r\n OS: Linux 5.4 Alpine Linux\r\n CPU: (6) x64 Intel(R) Core(TM) i5-8400 CPU @ 2.80GHz\r\n Memory: 1.05 GB / 5.80 GB\r\n Container: Yes\r\n Shell: 1.32.1 - /bin/ash\r\n Binaries:\r\n Node: 16.8.0 - /usr/local/bin/node\r\n npm: 7.21.0 - /usr/local/bin/npm\r\n npmPackages:\r\n vitepress: ^0.16.1 => 0.16.1\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.",[],388,"closed","Adding [[toc]] generates div inside p element and causes a hydration mismatch","2023-01-21T14:35:54Z","https://github.com/vuejs/vitepress/issues/388",0.6957897,{"description":3198,"labels":3199,"number":3200,"owner":3155,"repository":3156,"state":3192,"title":3201,"updated_at":3202,"url":3203,"score":3204},"### Describe the bug\n\nRendered error with toc in headline.\r\n\r\nindex.md\r\n```\r\n[[toc]]\r\n\r\n### `\u003Cpath>`\r\n```\n\n### Reproduction\n\nhttps://stackblitz.com/edit/github-zbjrsg-7dahpw?file=index.md\r\n\r\n\n\n### Expected behavior\n\n```\r\n at createCompilerError (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:19:19)\r\n at emitError (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1594:29)\r\n at parseElement (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1146:9)\r\n at parseChildren (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1125:22)\r\n at parseChildren (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1125:22)\r\n at parseChildren (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n at parseElement (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:1125:22)\r\n at parseChildren (D:\\wgf\\My Documents\\GitHub\\vueprojects\\vitepress_demo\\node_modules\\.pnpm\\@vue+compiler-core@3.2.31\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.js:937:28)\r\n```\n\n### System Info\n\n```shell\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/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.",[],605,"render error with toc and escapse \u003Ctag>","2023-01-21T14:35:50Z","https://github.com/vuejs/vitepress/issues/605",0.701576,{"description":3206,"labels":3207,"number":3209,"owner":3155,"repository":3156,"state":3192,"title":3210,"updated_at":3211,"url":3212,"score":3213},"### Describe the bug\n\nts Symbol error:\r\n\r\nPartial\u003CT>\n\n### Reproduction\n\nPartial\u003CT>\n\n### Expected behavior\n\nPartial\u003CT> is OK\n\n### System Info\n\n```sh\nSystem:\r\n OS: macOS 14.0\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 334.34 MB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 19.5.0 - ~/.nvm/versions/node/v19.5.0/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 9.4.1 - ~/.nvm/versions/node/v19.5.0/bin/npm\r\n pnpm: 8.6.12 - ~/.nvm/versions/node/v19.5.0/bin/pnpm\r\n Browsers:\r\n Chrome: 115.0.5790.170\r\n Safari: 17.0\r\n npmPackages:\r\n vitepress: 1.0.0-beta.7 => 1.0.0-beta.7\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.",[3208],{"name":3152,"color":3153},2764,"Element is missing end tag","2023-08-17T00:04:09Z","https://github.com/vuejs/vitepress/issues/2764",0.7071472,{"description":3215,"labels":3216,"number":3220,"owner":3155,"repository":3156,"state":3192,"title":3221,"updated_at":3222,"url":3223,"score":3224},"### Describe the bug\n\nAdding [[toc]] to the docs results in `Hydration completed but contains mismatches.` error in the browser.\n\n### Reproduction\n\n1. Create doc with [[toc]]\r\n```\r\n[[toc]]\r\n\r\n## test\r\n\r\ntest\r\n```\r\n2. Run `vitepress build docs`\r\n3. Run `vitepress serve docs`\r\n4. Open docs in the browser and refresh page\n\n### Expected behavior\n\nUsing toc shouldn't result in hydration mismatch\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (24) x64 AMD Ryzen 9 3900X 12-Core Processor\r\n Memory: 20.34 GB / 31.95 GB\r\n Binaries:\r\n Node: 14.18.3 - D:\\nodejs\\node.EXE\r\n Yarn: 1.22.17 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 6.14.15 - D:\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 105.0.5195.102\r\n Edge: Spartan (44.19041.1266.0), Chromium (105.0.1343.27)\r\n Internet Explorer: 11.0.19041.1566\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.",[3217],{"name":3218,"color":3219},"need more info","bdbefc",1313,"Using [[toc]] causes hydration mismatch","2023-01-21T14:25:34Z","https://github.com/vuejs/vitepress/issues/1313",0.7133213,{"description":3226,"labels":3227,"number":3229,"owner":3155,"repository":3156,"state":3192,"title":3230,"updated_at":3231,"url":3232,"score":3233},"### Describe the bug\n\n\u003Cimg width=\"269\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/10622fbc-efb0-4dbd-a342-5c4e73ed04a0\">\r\n\u003Cimg width=\"1272\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/61684763/42577ef3-634d-459e-bf05-97ada3afef7b\">\r\n以前旧版本是没有这个问题的。升级后才有的。\n\n### Reproduction\n\n升级vitepress打包部署后出现的\n\n### Expected behavior\n\n望能修复正常\n\n### System Info\n\n```sh\nSystem:\r\n OS: macOS 13.4.1\r\n CPU: (8) arm64 Apple M1\r\n Memory: 57.69 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 16.14.0 - ~/.nvm/versions/node/v16.14.0/bin/node\r\n Yarn: 1.22.19 - ~/.nvm/versions/node/v16.14.0/bin/yarn\r\n npm: 9.8.0 - ~/.nvm/versions/node/v16.14.0/bin/npm\r\n Watchman: 2023.03.27.00 - /opt/homebrew/bin/watchman\r\n Browsers:\r\n Chrome: 115.0.5790.170\r\n Safari: 16.5.2\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.",[3228],{"name":3152,"color":3153},2772,"升级vitepress后部署到阿里云服务器后,刷新页面会404","2023-08-18T00:04:13Z","https://github.com/vuejs/vitepress/issues/2772",0.71752465,{"description":3235,"labels":3236,"number":3238,"owner":3155,"repository":3156,"state":3192,"title":3239,"updated_at":3240,"url":3241,"score":3242},"### Describe the bug\n\nPlacing a table of contents shortcode after a custom container (tip, warning, danger, etc) will cause the table of contents element to render empty with no children.\n\n### Reproduction\n\nindex.md:\r\n\r\n```\r\n# Test page\r\n\r\n::: warning\r\nThis will cause the toc to be empty\r\n:::\r\n\r\n[[toc]]\r\n\r\n## section 1\r\n## section 2\r\n### subsection 2a\r\n## section 3\r\n```\n\n### Expected behavior\n\nThe TOC outline should be populated with children but instead it just renders as `\u003Cnav class=\"table-of-contents\">\u003C/nav>`\n\n### System Info\n\n```shell\nSystem:\r\n OS: Linux 5.18 Arch Linux\r\n CPU: (32) x64 AMD Ryzen 9 5950X 16-Core Processor\r\n Memory: 91.45 GB / 125.72 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 18.7.0 - /usr/bin/node\r\n npm: 8.15.1 - /usr/bin/npm\r\n Browsers:\r\n Chromium: 103.0.5060.134\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/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.",[3237],{"name":3166,"color":3167},1093,"`[[toc]]` not working after using custom containers","2023-01-21T14:27:00Z","https://github.com/vuejs/vitepress/issues/1093",0.723385,{"description":3244,"labels":3245,"number":3247,"owner":3155,"repository":3156,"state":3192,"title":3248,"updated_at":3249,"url":3250,"score":3251},"### Describe the bug\r\n\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nyarn add vitepress\r\n\r\nedit package.json\r\n\r\n~~~\r\n \"scripts\": {\r\n \"docs:dev\": \"vitepress dev docs\",\r\n \"docs:build\": \"vitepress build docs\",\r\n \"docs:serve\": \"vitepress serve docs\"\r\n }\r\n~~~\r\n\r\nyarn docs:dev\r\n\r\n### Expected behavior\r\n\r\nnormal display\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: Windows 10 10.0.17763\r\n CPU: (8) x64 Intel(R) Xeon(R) CPU E3-1230 V2 @ 3.30GHz\r\n Memory: 3.25 GB / 7.93 GB\r\n Binaries:\r\n Node: 16.5.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.10 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 7.20.5 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 92.0.4515.107\r\n Edge: Spartan (44.17763.831.0)\r\n Internet Explorer: 11.0.17763.771\r\n npmPackages:\r\n vitepress: ^0.16.1 => 0.16.1\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/coc)\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.",[3246],{"name":3152,"color":3153},362,"Strange symbols appear","2023-01-21T16:22:12Z","https://github.com/vuejs/vitepress/issues/362",0.7245996,["Reactive",3253],{},["Set"],["ShallowReactive",3256],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fk4pzsX1WklnhRD5vUz0BjVUms_23Og0cU4eIbCwgvKM":-1},"/vuejs/vitepress/4908"]