\r\n```\r\n\r\nAlternatively, use the `desc` defined in the `container` to write Markdown syntax.\r\n\r\n```md\r\n::: demo src=\"../demo.vue\" title=\"Demo block\"\r\n\r\nThis is a `description` that can be written using Markdown.\r\n\r\n:::\r\n```\r\n\r\n### Describe the solution you'd like\r\n\r\nTo address this, I have created the [markdown-it-vitepress-demo](https://github.com/hairyf/markdown-it-vitepress-demo) plugin. I'm not sure if it can be helpful.\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- https://github.com/vuejs/vitepress/issues/987\r\n- https://github.com/vuejs/vitepress/issues/1349\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.",[2856],{"name":2857,"color":2858},"stale","ededed",2432,"vuejs","vitepress","open","feat(demo): built-in markdown plugin provides support for showcasing demo capabilities.","2024-07-17T14:37:26Z","https://github.com/vuejs/vitepress/issues/2432",0.6411848,{"description":2868,"labels":2869,"number":2873,"owner":2860,"repository":2861,"state":2874,"title":2875,"updated_at":2876,"url":2877,"score":2878},"### Describe the bug\n\nI get errors inside VS Code inside a simple vue component:\r\n\r\n\u003Cimg width=\"887\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/10713751/50437808-5667-4930-9aa8-d5eba16e2d29\">\r\n\r\nWhen using the component inside a markdown file, it works as expected.\n\n### Reproduction\n\nCreate a new VitePress project using the guide. Create a new component vue somewhere.\n\n### Expected behavior\n\nNo errors reported.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.3.1\r\n CPU: (11) arm64 Apple M3 Pro\r\n Memory: 89.45 MB / 18.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.11.0 - ~/.nvm/versions/node/v18.11.0/bin/node\r\n npm: 8.19.2 - ~/.nvm/versions/node/v18.11.0/bin/npm\r\n pnpm: 8.11.0 - ~/.nvm/versions/node/v18.11.0/bin/pnpm\r\n bun: 1.0.29 - ~/.bun/bin/bun\r\n Browsers:\r\n Chrome: 122.0.6261.112\r\n Safari: 17.3.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.44 => 1.0.0-rc.44\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.",[2870],{"name":2871,"color":2872},"bug: pending triage","e99695",3645,"closed","TypeScript in VS Code reports error in vue component","2024-03-16T00:04:08Z","https://github.com/vuejs/vitepress/issues/3645",0.62748563,{"description":2880,"labels":2881,"number":2883,"owner":2860,"repository":2861,"state":2874,"title":2884,"updated_at":2885,"url":2886,"score":2887},"### Describe the bug\n\nI added team component feedback error in index.md\r\n\r\n\n\n### Reproduction\n\n---\r\nlayout: home\r\n\r\nhero:\r\n name: VitePress\r\n text: Vite & Vue powered static site generator.\r\n tagline: Simple, powerful, and performant. Meet the modern SSG framework you've always wanted.\r\n actions:\r\n - theme: brand\r\n text: Get Started\r\n link: /example\r\n - theme: alt\r\n text: View on GitHub\r\n link: https://github.com/vuejs/vitepress\r\n---\r\n\r\n\u003Cscript setup>\r\nimport { VPTeamMembers } from 'vitepress/theme'\r\n\r\nconst members = [\r\n {\r\n avatar: 'https://www.github.com/yyx990803.png',\r\n name: 'Evan You',\r\n title: 'Creator',\r\n links: [\r\n { icon: 'github', link: 'https://github.com/yyx990803' },\r\n { icon: 'twitter', link: 'https://twitter.com/youyuxi' }\r\n ]\r\n },\r\n ...\r\n]\r\n\u003C/script>\r\n\r\n# Our Team\r\n\r\nSay hello to our awesome team.\r\n\r\n\u003CVPTeamMembers size=\"small\" :members=\"members\" />\r\n\n\n### Expected behavior\n\nnormal\n\n### System Info\n\n```Text\nSystem:\r\n OS: Linux 5.0 undefined\r\n CPU: (8) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 0 Bytes / 0 Bytes\r\n Shell: 1.0 - /bin/jsh\r\n Binaries:\r\n Node: 18.20.3 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 10.2.3 - /usr/local/bin/npm\r\n pnpm: 8.15.6 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: latest => 1.3.4\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.",[2882],{"name":2871,"color":2872},4238,"Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.6331693,{"description":2889,"labels":2890,"number":2892,"owner":2860,"repository":2861,"state":2874,"title":2893,"updated_at":2894,"url":2895,"score":2896},"\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\nWhen I use the components directly in markdown file, It raised a waring with `vue.js:1099 [Vue warn]: Failed to resolve componen` as:\r\n\r\n\r\n\r\nDoes vitepress auto register components in `.vitepress/components`? or where can I put the `.vue` files and how to use them? thank you.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\n\r\n**Expected behavior**\r\nA clear and concise description of what you expected to happen.\r\n\r\n**System Info**\r\n- vitepress version:\r\n- vite version:\r\n- Node version:\r\n- OS version:\r\n\r\n**Additional context**\r\nAdd any other context about the problem here.\r\n",[2891],{"name":2871,"color":2872},60,"Is vitepress auto register components in `.vitepress/components`?","2023-01-21T16:25:31Z","https://github.com/vuejs/vitepress/issues/60",0.63980657,{"description":2898,"labels":2899,"number":2901,"owner":2860,"repository":2861,"state":2874,"title":2902,"updated_at":2903,"url":2904,"score":2905},"### Describe the bug\r\n\r\nI'm documenting some ember addon. Ember and Vue use double curly syntax. Here is my markdown snippet that currently has a parser error:\r\n\r\n```md\r\nThus, a code such as `{{on \"click\" inc}}` would break as Ember is not able to make that association.\r\n```\r\n\r\nWhich fails with the error message:\r\n\r\n```\r\n[plugin:vite:vue] Error parsing JavaScript expression: Unexpected token, expected \",\" (1:4)\r\n```\r\n\r\nHere the screenshot of the error message. The extracted code snippet is actually not the real reason - I guess the parser is confused here.\r\n\r\n\u003Cimg width=\"886\" alt=\"Bildschirmfoto 2023-10-07 um 11 48 42\" src=\"https://github.com/vuejs/vitepress/assets/283700/6e1ec7a3-92e5-4537-856e-57813de3227c\">\r\n\r\n### Reproduction\r\n\r\nEnter the snippet above into any markdown file and vitepress will show the error.\r\n\r\n### Expected behavior\r\n\r\nWithin code backticks, I'd expect vitepress not trying to execute vue code.\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 13.4.1\r\n CPU: (8) x64 Intel(R) Core(TM) i7-8559U CPU @ 2.70GHz\r\n Memory: 11.69 MB / 16.00 GB\r\n Shell: 3.6.1 - /usr/local/bin/fish\r\n Binaries:\r\n Node: 18.16.0 - ~/.volta/tools/image/node/18.16.0/bin/node\r\n Yarn: 1.22.19 - ~/.volta/tools/image/yarn/1.22.19/bin/yarn\r\n npm: 9.5.1 - ~/.volta/tools/image/node/18.16.0/bin/npm\r\n pnpm: 8.8.0 - ~/.volta/bin/pnpm\r\n Watchman: 2023.08.14.00 - /usr/local/bin/watchman\r\n Browsers:\r\n Brave Browser: 103.1.41.100\r\n Chrome: 117.0.5938.149\r\n Edge: 117.0.2045.47\r\n Safari: 16.5.2\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.20 => 1.0.0-rc.20\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.",[2900],{"name":2871,"color":2872},3053,"Markdown Parser fails with `{{`","2023-10-15T00:04:48Z","https://github.com/vuejs/vitepress/issues/3053",0.6425297,{"description":2907,"labels":2908,"number":2909,"owner":2860,"repository":2861,"state":2874,"title":2910,"updated_at":2911,"url":2912,"score":2913},"### Describe the bug\n\n\r\n\r\n我的组件库是基于element ui 二次封装 正常打包 且在项目内可以使用\r\n在使用vitepress 开发文档时 运行无任何问题,能正常显示组件\r\n可是打包一堆问题\r\n\n\n### Reproduction\n\n使用element 封装 打包 嵌入vitepress\r\n\n\n### Expected behavior\n\n预期打包成功\n\n### System Info\n\n```shell\nTypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension \".css\" for /Users/allen/Desktop/ode/turborepo/node_modules/.pnpm/registry.npmmirror.com+element-plus@2.2.17_vue@3.2.40/node_modules/element-plus/theme-chalk/el-cascader.css\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.",[],1465,"vitepress 打包错误","2023-01-21T14:23:01Z","https://github.com/vuejs/vitepress/issues/1465",0.642886,{"description":2915,"labels":2916,"number":2918,"owner":2860,"repository":2861,"state":2874,"title":2919,"updated_at":2920,"url":2921,"score":2922},"**Describe the bug**\r\n\r\nWhen using vitepress with vue v3.1, we are now running into a compilation error as some vitepress components are using `\u003Ctemplate functional>`\r\n\r\nThe related change in vue-next is https://github.com/vuejs/vue-next/commit/467076361a730b7925c88c572793c78637e05ca7\r\n\r\n**To Reproduce**\r\n\r\nSee [this PR in VTU](https://github.com/vuejs/vue-test-utils-next/pull/654) (that uses vitepress for the docs) that fails because of vitepress and vue 3.1 \r\n\r\nIt can easily be reproduced in the current codebase by bumping vue to v3.1 and run `yarn docs-build`:\r\n\r\n```\r\nSyntaxError: \u003Ctemplate functional> is no longer supported in Vue 3, since functional components no longer have significant performance difference from stateful ones. Just use a normal \u003Ctemplate> instead.\r\n at /Users/ced-pro/Code/vue/vitepress/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:196:37\r\n at Array.forEach (\u003Canonymous>)\r\n at parse (/Users/ced-pro/Code/vue/vitepress/node_modules/@vue/compiler-sfc/dist/compiler-sfc.cjs.js:182:18)\r\n at createDescriptor (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4048:62)\r\n at transformMain (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4344:32)\r\n at Object.transform (/Users/ced-pro/Code/vue/vitepress/node_modules/@vitejs/plugin-vue/dist/index.js:4665:16)\r\n at /Users/ced-pro/Code/vue/vitepress/node_modules/rollup/dist/shared/rollup.js:19875:25 {\r\n loc: {\r\n start: { column: 11, line: 1, offset: 10 },\r\n end: { column: 21, line: 1, offset: 20 },\r\n source: 'functional'\r\n },\r\n id: '/Users/ced-pro/Code/vue/vitepress/dist/client/theme-default/com\r\n```\r\n\r\n**Expected behavior**\r\nvitepress should properly compile with Vue v3.1\r\n\r\n**System Info**\r\n- vitepress version: 0.14\r\n- vite version: 2.3.4\r\n- Node version: 14.17\r\n- OS version: macOS\r\n",[2917],{"name":2871,"color":2872},311,"Functional templates errors with vue v3.1","2023-01-21T16:22:22Z","https://github.com/vuejs/vitepress/issues/311",0.64344156,{"description":2924,"labels":2925,"number":2929,"owner":2860,"repository":2861,"state":2874,"title":2930,"updated_at":2931,"url":2932,"score":2933},"### Describe the bug\r\n\r\nSome of the code markdown extensions do not work when the language is `vue`.\r\n\r\nIn particular, `[!code ++]`, `[!code --]`, `[!code warning]`, `[!code error]` and `[!code focus]` just show the comments at the end of the line.\r\n\r\nChanging the language to something else fixes this, e.g. `htmx` or `ts`.\r\n\r\nThis only seems to happen in the template tags of a `vue` code block. The highlighting works absolutely fine in the script part. Please see reproduction for code examples, I can't figure out how to escape the triple backtick code blocks here! ☹️ \r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/edit/vite-arupmh?file=docs%2Fexample.md\r\n\r\n### Expected behavior\r\n\r\nThe markdown extensions should work correctly and highlight the lines as per [the docs](https://vitepress.dev/guide/markdown#focus-in-code-blocks).\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 14.1.2\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 488.47 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\nBinaries:\r\n Node: 18.12.1 - ~/.nvm/versions/node/v18.12.1/bin/node\r\n Yarn: 1.22.10 - /usr/local/bin/yarn\r\n npm: 8.19.2 - ~/.nvm/versions/node/v18.12.1/bin/npm\r\nBrowsers:\r\n Chrome: 120.0.6099.234\r\n Firefox: 112.0.2\r\n Firefox Developer Edition: 107.0\r\n Safari: 17.1.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] 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.",[2926],{"name":2927,"color":2928},"upstream","BF29ED",3503,"Markdown code extensions don't work in some situations","2025-02-01T04:42:47Z","https://github.com/vuejs/vitepress/issues/3503",0.6435622,{"description":2935,"labels":2936,"number":2940,"owner":2860,"repository":2861,"state":2874,"title":2941,"updated_at":2942,"url":2943,"score":2944},"### Describe the bug\n\n很多时候在 `vitepress` 中难免使用到 `document`,但是 `vitepress` 使用服务端渲染方式,如何避免其打包的错误呢?\r\n\r\n有什么第三方插件推荐或者配置项吗?\r\n\r\n\u003Chr />\r\n\r\nIt is inevitable to use `document` in `vitepress` many times, but how to avoid the packaging error when` vitepress` uses the server-side rendering method?\r\n\r\nAre there any third-party plug-in recommendations or configuration items?\n\n### Reproduction\n\n```vue\r\n\u003Cscript setup>\r\n console.log(document)\r\n\u003C/script>\r\n```\r\n\r\n\r\n\n\n### Expected behavior\n\nBuild ok\n\n### System Info\n\n```shell\n\"vitepress\": \"^1.0.0-alpha.4\",\r\n\"vue\": \"^3.2.33\"\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.",[2937],{"name":2938,"color":2939},"question","5D5FAE",1120,"document is not defined","2023-01-21T14:28:51Z","https://github.com/vuejs/vitepress/issues/1120",0.64644873,{"description":2946,"labels":2947,"number":2951,"owner":2860,"repository":2861,"state":2874,"title":2952,"updated_at":2953,"url":2954,"score":2955},"### Describe the bug\n\nI referenced a globally registered component in the markdown document of vitepress. When I used it, the error was reported as follows:\r\n**[vitepress] Internal server error: At least one \u003Ctemplate> or \u003Cscript> is required in a single file component.**\r\n\r\n\r\n\n\n### Reproduction\n\nCreate vite.config.js in the vitepress root directory, the content is as follows:\r\n\r\n```\r\nimport { defineConfig } from \"vite\";\r\nimport vueJsx from \"@vitejs/plugin-vue-jsx\";\r\nimport vue from \"@vitejs/plugin-vue\"\r\nexport default defineConfig({\r\n plugins: [\r\n vue(),\r\n vueJsx(),\r\n ],\r\n});\r\n```\n\n### Expected behavior\n\nRender component content correctly\n\n### System Info\n\n```shell\nnode 16\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.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2948],{"name":2949,"color":2950},"need more info","bdbefc",2095,"vitepress not support jsx file?","2023-03-29T00:04:14Z","https://github.com/vuejs/vitepress/issues/2095",0.649789,["Reactive",2957],{},["Set"],["ShallowReactive",2960],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fZIMN-AtmWbuXe7VgJtfixD66kLcduzWotFjGft85b7Y":-1},"/vuejs/vitepress/3485"]