\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.",[3053],{"name":3040,"color":3041},2432,"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.76859194,{"description":3060,"labels":3061,"number":3065,"owner":3043,"repository":3044,"state":3066,"title":3067,"updated_at":3068,"url":3069,"score":3070},"How to use the browser api like vuepress?",[3062],{"name":3063,"color":3064},"need more info","bdbefc",222,"closed","Use the browser API","2023-01-21T16:22:29Z","https://github.com/vuejs/vitepress/issues/222",0.68084633,{"description":3072,"labels":3073,"number":3074,"owner":3043,"repository":3044,"state":3066,"title":3075,"updated_at":3076,"url":3077,"score":3078},"### Is your feature request related to a problem? Please describe.\n\nBefore, I want to use the third-party component library [element-plus](https://element-plus.gitee.io/#/zh-CN) in vuepress, which can be directly in [clientAppEnhance.ts](https://v2.vuepress.vuejs.org/zh/reference/client-api.html#%E8%BF%9B%E9%98%B6%E8%83%BD%E5%8A%9B) folder for app Use(). The code is as follows:\r\n\r\n```js\r\nimport { defineClientAppEnhance } from '@vuepress/client'\r\n\r\nimport elementPlus from 'element-pus'\r\n\r\nexport default defineClientAppEnhance(({ app, router, siteData }) => {\r\n app.use(elementPlus)\r\n})\r\n```\r\n\r\nSo how do I use third-party libraries in vitepress?\n\n### Describe the solution you'd like\n\nI hope to supplement the detailed configuration of the [document](https://vitepress.vuejs.org/). Now the content of the document configuration of vitepress is too few, and it is difficult for novices to get started with 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.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.",[],603,"How to use third-party libraries?","2023-01-21T14:28:45Z","https://github.com/vuejs/vitepress/issues/603",0.72121197,{"description":3080,"labels":3081,"number":3085,"owner":3043,"repository":3044,"state":3066,"title":3086,"updated_at":3087,"url":3088,"score":3089},"\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 was included element-plus as official document , but there was error about vue3 proxy\r\n index.esm.js: 1 Uncaught (in promise) TypeError: Cannot read property 'proxy' of null\r\n\r\n**To Reproduce**\r\n1.git clone from https://github.com/zhaowenlin/demo\r\n2.yarn install\r\n3.npm run dev\r\n4.访问http://localhost:3000/\r\n5.点击快速上手\r\n\r\n**Expected behavior**\r\nrender normally\r\n\r\n**System Info**\r\n- vitepress version: 0.12.2\r\n- vite version:2.1.5\r\n- Node version: 14.15.5\r\n- OS version: 10.14.6\r\n\r\n**Additional context**\r\nAdd any other context about the problem here.\r\n",[3082],{"name":3083,"color":3084},"question","5D5FAE",282,"vitepress not support element-plus? ","2023-01-21T14:35:38Z","https://github.com/vuejs/vitepress/issues/282",0.7222836,{"description":3091,"labels":3092,"number":3093,"owner":3043,"repository":3044,"state":3066,"title":3094,"updated_at":3095,"url":3096,"score":3097},"### Is your feature request related to a problem? Please describe.\r\n\r\n许多第三方库会在导入时的顶层代码中访问 `window` 或者 `document`\r\n我不可能在第三库的源码中加上条件判断,这是不切实际的。\r\n\r\n假设有一个Vue插件模块名字就叫 \"a-vue-plugin\",并且假设它提供了大量有用的Vue组件或者实用功能。\r\n```typescript\r\nwindow.ABC = 123 // 这个模块在代码顶层就访问里 window\r\n\r\nconst plugin = {\r\n // ...\r\n}\r\n\r\nexport default plugin\r\n```\r\n\r\ndocs/.vitepress/theme/index.ts\r\n```typescript\r\n// ...\r\nimport { plugin } from 'a-vue-plugin''\r\n\r\nexport default define\u003CTheme>({\r\n NotFound,\r\n Layout: VPApp,\r\n enhanceApp: ({ app }) => {\r\n // 这样写显然是无济于事的,因为在执行 import { plugin } from 'a-vue-plugin' 时就已经访问到 window 了 \r\n if (!import.meta.env.SSR) {\r\n app.use(plugin) // 这里需要使用这个插件\r\n }\r\n },\r\n})\r\n```\r\n最终抛出错误\r\n```\r\n⠋ rendering pages...ReferenceError: window is not defined\r\n```\r\n\r\n### Describe the solution you'd like\r\n\r\n目前缺少完全合理的解决方案,请求官方针对此问题提供标准的解决方案或者规避方案。\r\n\r\n### Describe alternatives you've considered\r\n\r\n这是一个可能的解决方案,但需要 enhanceApp 支持异步才行。\r\n```typescript\r\nexport default define\u003CTheme>({\r\n NotFound,\r\n Layout: VPApp,\r\n enhanceApp: async ({ app }) => {\r\n if (!import.meta.env.SSR) {\r\n const plugin = (await import('a-vue-plugin')).default\r\n app.use(plugin)\r\n }\r\n },\r\n})\r\n```\r\n\r\n### Additional context\r\n\r\n类似的问题 [#](https://github.com/vuejs/vitepress/issues/1727#issue-1507239476)\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.",[],1884,"如何针对静态导入跳过SSR?","2023-03-23T00:04:27Z","https://github.com/vuejs/vitepress/issues/1884",0.7272352,{"description":3099,"labels":3100,"number":3104,"owner":3043,"repository":3044,"state":3066,"title":3105,"updated_at":3106,"url":3107,"score":3108},"### Describe the bug\n\nHey, \r\n\r\nIt's not a bug report, just a question.\r\n\r\nHow to install with a module who's use browser features (document.querySelectorAll) with `ctx.app.use()` on client side ? \r\n\r\nI can't find the way in the documentation. In VuePress, we can use the variable `__VUEPRESS_SSR__`, do you something similar in VitePress ? \r\n\r\nN.B: It's works fine with the dev serve but fail on build time\r\n\r\n## In VuePress\r\n\r\n`docs/.vuepress/client.ts`\r\n\r\n```ts\r\nimport { defineClientConfig } from '@vuepress/client'\r\nimport { clientModule } from 'lib'\r\n\r\nexport default defineClientConfig({\r\n enhance: async ({ app, router }) => {\r\n if (!__VUEPRESS_SSR__) {\r\n app.use(clientModule)\r\n }\r\n }\r\n})\r\n```\r\n\r\n## In VitePress \r\n\r\n`docs/.vitepress/theme/index.ts`\r\n\r\n```ts\r\nconst theme: typeof DefaultTheme = {\r\n ...DefaultTheme,\r\n enhanceApp({ app }) {\r\n app.use(clientModule) // It's doesn't works 😑\r\n },\r\n}\r\n```\r\n\r\n\n\n### Reproduction\n\n-\n\n### Expected behavior\n\nBe able to build the app with client\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.6.1\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 314.09 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.18.1 - /opt/homebrew/opt/node@16/bin/node\r\n Yarn: 1.22.19 - ~/.yarn/bin/yarn\r\n npm: 8.19.2 - /opt/homebrew/opt/node@16/bin/npm\r\n Browsers:\r\n Chrome: 108.0.5359.98\r\n Firefox: 101.0.1\r\n Safari: 15.6.1\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.30 => 1.0.0-alpha.30\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.",[3101],{"name":3102,"color":3103},"bug: pending triage","e99695",1681,"[QUESTION] checking if in client side to install plugin","2023-01-21T14:20:27Z","https://github.com/vuejs/vitepress/issues/1681",0.7332653,{"description":3110,"labels":3111,"number":665,"owner":3043,"repository":3044,"state":3066,"title":3112,"updated_at":3113,"url":3114,"score":3115},"As a member of current vuepress team, I just created a prototype for vuepress next major version: https://github.com/vuepress/vuepress-next\r\n\r\n- Vue 3 ecosystem\r\n- Typescript\r\n- Drop class API, use compositional functions\r\n- Try do decouple with webpack, may support different bundlers (e.g. vite)\r\n\r\nToday I noticed vitepress and don't know where to go next 😢 \r\n\r\n@yyx990803 Could you please give some advice? ",[],"Just created vuepress-next prototype before noticed this project","2023-01-21T16:24:21Z","https://github.com/vuejs/vitepress/issues/13",0.73697084,{"description":3117,"labels":3118,"number":3119,"owner":3043,"repository":3044,"state":3066,"title":3120,"updated_at":3121,"url":3122,"score":3123},"**Is your feature request related to a problem? Please describe.**\r\n\r\nCurrently a VuePress user and excited to move to VitePress (primarily because I've written my own VP themes from scratch, and this seems to be the main design goal for v3) but:\r\n\r\n- there are various key differences between the frameworks (bundler, plugins, config)\r\n- there are significant intentional omissions in v3 (rather large list in the docs)\r\n- it's still in development\r\n\r\nAs a new / migrating user, it's a bit of a minefield and difficult to know where to start when something is omitted.\r\n\r\n**Describe the solution you'd like**\r\n\r\nRather than clogging up the issues with questions, it would be cool to get an Awesome VitePress list going, so users could find alternative plugins, or dig through the code of known solutions (i.e. the Vue Blog) and see how it's been solved before.\r\n\r\n**Describe alternatives you've considered**\r\n\r\nClog up the issues with questions, bug @kiaking on Twitter, Google solutions, etc.\r\n\r\n**Additional context**\r\n\r\nHappy to help search and review resources to get it started.\r\n\r\n",[],253,"List of examples or some kind of Awesome VitePress repo","2023-01-28T15:54:22Z","https://github.com/vuejs/vitepress/issues/253",0.74759775,{"description":3125,"labels":3126,"number":3127,"owner":3043,"repository":3044,"state":3066,"title":3125,"updated_at":3128,"url":3129,"score":3130},"请教个问题,如果用vitepress写组件库文档,但是我的组件库是vue2.*的,那么还能从vuepress换成vitepress吗?因为vuepress太慢了",[],274,"2023-01-21T16:22:27Z","https://github.com/vuejs/vitepress/issues/274",0.747994,["Reactive",3132],{},["Set"],["ShallowReactive",3135],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fEXRqpyymd4T11pSNlwTAu0QWrKkwIxMxt_surnNpjjk":-1},"/vuejs/vitepress/2491"]