\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.",[2867],{"name":2868,"color":2869},"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.6907335,{"description":2879,"labels":2880,"number":2884,"owner":2871,"repository":2872,"state":2885,"title":2886,"updated_at":2887,"url":2888,"score":2889},"### Describe the bug\n\nI want to use the vue component in vitepress. I have read the documentation on the official website, but when I do it, I encounter an error like this.\r\n```bash\r\n[plugin:vite:vue] Tags with side effect (\u003Cscript> and \u003Cstyle>) are ignored in client component templates.\r\n```\r\n\r\nI don't understand what I'm encountering, I just want to achieve the effect here in this vue document\r\n\r\n> https://cn.vuejs.org/guide/reusability/composables.html#vs-react-hooks\r\n\r\n\r\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-dn63jg?file=docs%2Fhooks%2FuseMouse.js,docs%2Fexample.md\n\n### Expected behavior\n\nThe documentation on the official website makes me understand the difficulty or the need for a better demo?\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (20) x64 13th Gen Intel(R) CoreT i7-13800H\r\n Memory: 17.07 GB / 31.74 GB\r\n Binaries:\r\n Node: 20.11.0 - ~\\AppData\\Local\\pnpm\\node.EXE\r\n npm: 10.2.4 - ~\\AppData\\Local\\pnpm\\npm.CMD\r\n pnpm: 8.14.1 - ~\\AppData\\Local\\pnpm\\pnpm.EXE\r\n Browsers:\r\n Edge: Chromium (120.0.2210.133)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: 1.0.0-rc.39 => 1.0.0-rc.39\n```\n\n\n### Additional context\n\nPlease tell me the correct way to write it, thank you\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.",[2881],{"name":2882,"color":2883},"bug: pending triage","e99695",3485,"closed","Using vue to report errors in markdown","2024-01-29T00:04:28Z","https://github.com/vuejs/vitepress/issues/3485",0.6443871,{"description":2891,"labels":2892,"number":2896,"owner":2871,"repository":2872,"state":2885,"title":2897,"updated_at":2898,"url":2899,"score":2900},"### 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.",[2893],{"name":2894,"color":2895},"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.64522994,{"description":2902,"labels":2903,"number":2905,"owner":2871,"repository":2872,"state":2885,"title":2906,"updated_at":2907,"url":2908,"score":2909},"### Describe the bug\n\n `{{.Title |html}}` Similar to this structure , Compilation error\n\n### Reproduction\n\n `{{.Title |html}}` \r\n\r\nbuild docs error: [vite] Internal server error: Error parsing JavaScript expression: Unexpected token (1:1)\n\n### Expected behavior\n\nCompilation passed\n\n### System Info\n\n```shell\n[vite] Internal server error: Error parsing JavaScript expression: Unexpected token (1: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/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.",[2904],{"name":2882,"color":2883},927,"Unfriendly to handlebarsjs support","2023-01-21T14:32:42Z","https://github.com/vuejs/vitepress/issues/927",0.66224736,{"description":2911,"labels":2912,"number":2914,"owner":2871,"repository":2872,"state":2885,"title":2915,"updated_at":2916,"url":2917,"score":2918},"### Describe the bug\n\nCannot build if there is md file in `./docs` , with special content. \r\n\n\n### Reproduction\n\nWhen there's such one md file in `./docs` :\r\n```markdown\r\n1. 内联样式 style 属性不接收字符串,要使用 `style={{key:value}}`\r\n``` \r\nThen I run `yarn docs:build`, command will fail with exit code 1.\r\n\r\nThe following is the error info in terminal:\r\n```\r\nvitepress v1.0.0-alpha.13\r\n⠦ building client + server bundles...[vite:vue] Error parsing JavaScript expression: Unexpected token, expected \",\" (1:4)\r\nfile: D:/GitRepo/gyhyfj/docs/react/ABC.md:2:43\r\n✖ building client + server bundles...\r\nbuild error:\r\n Error [SyntaxError]: Error parsing JavaScript expression: Unexpected token, expected \",\" (1:4)\r\n at createCompilerError (D:\\GitRepo\\gyhyfj\\node_modules\\.pnpm\\@vue+compiler-core@3.2.39\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.prod.js:18:19) \r\n at processExpression (D:\\GitRepo\\gyhyfj\\node_modules\\.pnpm\\@vue+compiler-core@3.2.39\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.prod.js:3423:25) \r\n at Array.transformExpression (D:\\GitRepo\\gyhyfj\\node_modules\\.pnpm\\@vue+compiler-core@3.2.39\\node_modules\\@vue\\compiler-core\\dist\\compiler-core.cjs.prod.js:3256:24)\r\n...\r\n...\r\n...\r\n ELIFECYCLE Command failed with exit code 1.\r\n```\r\n\r\nIf I delete this md files or delete this line, everything would be OK.\r\nThis problem can be reproducted whether on my PC or on Vercel\n\n### Expected behavior\n\nBuild command should work well as I don't delete this line in the md file.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (8) x64 Intel(R) Core(TM) i5-9300H CPU @ 2.40GHz\r\n Memory: 2.58 GB / 7.92 GB\r\nBinaries:\r\n Node: 16.16.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.11.0 - C:\\Program Files\\nodejs\\npm.CMD\r\nBrowsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (105.0.1343.33)\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.",[2913],{"name":2882,"color":2883},1330,"build error: Error [SyntaxError]: Error parsing JavaScript expression: Unexpected token, expected \",\" (1:4)","2023-01-21T14:25:33Z","https://github.com/vuejs/vitepress/issues/1330",0.6767731,{"description":2920,"labels":2921,"number":2923,"owner":2871,"repository":2872,"state":2885,"title":2924,"updated_at":2925,"url":2926,"score":2927},"### Describe the bug\n\nhttps://stackblitz.com/edit/vite-j7cesz?file=docs/index.md is the repro. Its `index.md` compiles just fine with some other established markdown compilers -- I tried pandoc and it worked well.\r\n\r\nI would like to know what's wrong with my markdown code! It can be that I don't understand the VitePress markdown syntax well enough, or maybe I am lucky to find a bug in the compiler 😉 I would like to provide additional info amap.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-j7cesz?file=docs/index.md\n\n### Expected behavior\n\nCompiles just fine.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Linux 5.15 Ubuntu 22.04.1 LTS 22.04.1 LTS (Jammy Jellyfish)\r\n CPU: (20) x64 12th Gen Intel(R) Core(TM) i7-12700H\r\n Memory: 5.91 GB / 7.61 GB\r\n Container: Yes\r\n Shell: 5.1.16 - /bin/bash\r\n Binaries:\r\n Node: 19.2.0 - /usr/bin/node\r\n npm: 8.19.3 - /usr/bin/npm\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.30 => 1.0.0-alpha.30\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.",[2922],{"name":2882,"color":2883},1673,"VitePress does not compile a HTML-markdown mixed file saying that 'Element is missing end tag'","2023-01-21T14:17:06Z","https://github.com/vuejs/vitepress/issues/1673",0.6790885,{"description":2929,"labels":2930,"number":2932,"owner":2871,"repository":2872,"state":2885,"title":2933,"updated_at":2934,"url":2935,"score":2936},"### Describe the bug\n\nWhen parsing Chinese Markdown content, VitePress generates an error message. I'm unable to determine the cause of this issue.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-vgqwpapn?file=docs%2Fexample.md,docs%2Fzh-example.md\n\n### Expected behavior\n\nwork to parse chinese\n\n### System Info\n\n```Text\nmacos 15.3.1\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.",[2931],{"name":2882,"color":2883},4767,"Render content or parse content fail","2025-06-01T12:58:09Z","https://github.com/vuejs/vitepress/issues/4767",0.6804056,{"description":2938,"labels":2939,"number":2941,"owner":2871,"repository":2872,"state":2885,"title":2942,"updated_at":2943,"url":2944,"score":2945},"### Describe the bug\r\n\r\nerror detail: https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775\r\n\r\nI miss the error in update a markdown file, file:https://raw.githubusercontent.com/scopor/wiki/main/docs/reading/css.md\r\n\r\nRun yarn docs:build\r\n yarn docs:build\r\n shell: /usr/bin/bash -e {0}\r\nyarn run v1.[2](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:2)2.19\r\n$ vitepress build docs\r\nvitepress v1.0.0-alpha.17\r\n- building client + server bundles...\r\n[vite:vue] Element is missing end tag.\r\nfile: /home/runner/work/wiki/wiki/docs/reading/css.md:208:110\r\n✖ building client + server bundles...\r\nbuild error:\r\n Error [SyntaxError]: Element is missing end tag.\r\n at createCompilerError (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:18:19)\r\n at emitError (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:157[3](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:3):29)\r\n at parseElement (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:11[4](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:5)8:9)\r\n at parseChildren (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:932:28)\r\n at parseElement (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:112[7](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:8):22)\r\n at parseChildren (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:932:2[8](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:9))\r\n at parseElement (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:1127:22)\r\n at parseChildren (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:[9](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:10)32:28)\r\n at parseElement (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:1127:22)\r\n at parseChildren (/home/runner/work/wiki/wiki/node_modules/@vue/compiler-core/dist/compiler-core.cjs.prod.js:932:28) {\r\n id: '/home/runner/work/wiki/wiki/docs/reading/css.md',\r\n plugin: 'vite:vue',\r\n loc: {\r\n file: '/home/runner/work/wiki/wiki/docs/reading/css.md',\r\n line: 208,\r\n column: 1[10](https://github.com/scopor/wiki/actions/runs/3417036686/jobs/5687761775#step:6:11)\r\n },\r\n\r\n### Reproduction\r\n\r\n1、modify file\r\n2、trigger github actions: yarn docs:build\r\n\r\n### Expected behavior\r\n\r\nyarn docs:build\r\n\r\n### System Info\r\n\r\ngithub actions\r\n\r\n```shell\r\nvitepress v1.0.0-alpha.17\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.",[2940],{"name":2882,"color":2883},1590,"Element is missing end tag","2023-01-21T14:20:50Z","https://github.com/vuejs/vitepress/issues/1590",0.6820946,{"description":2947,"labels":2948,"number":2952,"owner":2871,"repository":2872,"state":2885,"title":2953,"updated_at":2954,"url":2955,"score":2956},"### Describe the bug\n\nStraight quotes are not converted into curly quotes by `markdown-it`.\n\n### Reproduction\n\nCreate a new `vitepress` project using stackblitz, add `\"hello world\"` to the `index.md`, and it will be rendered with straight quotes.\n\n### Expected behavior\n\nAccording to the settings of `markdown-it` (see [demo](https://markdown-it.github.io/)) they should be replaced with smart quotes\n\n### System Info\n\n```sh\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: 16.20.0 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 9.4.2 - /usr/local/bin/npm\r\n pnpm: 8.6.10 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: latest => 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.",[2949],{"name":2950,"color":2951},"wont fix","EDEED1",2894,"Curly Quotes Not Working","2023-09-09T00:04:03Z","https://github.com/vuejs/vitepress/issues/2894",0.6832652,{"description":2958,"labels":2959,"number":2961,"owner":2871,"repository":2872,"state":2885,"title":2962,"updated_at":2963,"url":2964,"score":2965},"\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\n\r\nindex.md with\r\n\r\n```\r\n\u003Cfoo-bar>\r\nxxx\r\n\u003C/foo-bar>\r\n```\r\nwill throw error\r\n\r\n``` bash\r\n[vite] SFC template compilation error: \r\ndocs/index.md:4:1\r\nElement is missing end tag.\r\n1 | \r\n2 | \u003Ctemplate>\u003Cdiv>\u003Ch1 id=\"test\">\u003Ca class=\"header-anchor\" href=\"#test\" aria-hidden=\"true\">#\u003C/a> test\u003C/h1>\r\n3 | \u003Cfoo-bar>\r\n | ^\r\n4 | \u003Cp>xxx\r\n5 | \u003C/foo-bar>\u003C/p>\r\n\r\ndocs/index.md:5:11\r\nInvalid end tag.\r\n3 | \u003Cfoo-bar>\r\n4 | \u003Cp>xxx\r\n5 | \u003C/foo-bar>\u003C/p>\r\n | ^\r\n6 | \u003C/div>\u003C/template>\r\n```\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\n\r\nclone [my repo](https://github.com/xxholly32/vitepress-playground)\r\n\r\nrun `npm i && npm run docs`\r\n\r\n**Expected behavior**\r\nA clear and concise description of what you expected to happen.\r\n\r\nno error or warning and transform will be correct\r\n\r\n**System Info**\r\n- vitepress version:0.6.0\r\n- vite version:1.0.0-rc.3\r\n- Node version:v12.16\r\n- OS version:10.15\r\n",[2960],{"name":2882,"color":2883},95,"Multiline vue-components transform error ","2023-01-21T16:24:24Z","https://github.com/vuejs/vitepress/issues/95",0.68336874,["Reactive",2967],{},["Set"],["ShallowReactive",2970],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fQO6xIT4dGtqLvBAddi74f1AoyIQRhm-Ih3znz7xuEMw":-1},"/vuejs/vitepress/3053"]