\n\n\u003Cimg width=\"376\" height=\"181\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/2f33e227-2f78-4d2d-a90e-796eb5842643\" />\n\n### Reproduction\n\nUse the default tempalte \"no style\" and add a code block with line-numbers.\n\nTested version: \"vitepress\": \"^1.6.3\"\n\n### Expected behavior\n\nThe line numbers are next to the code.\n\n### System Info\n\n```Text\nSystem:\n OS: Windows 10 10.0.19045\n CPU: (16) x64 AMD Ryzen 7 5800X3D 8-Core Processor\n Memory: 11.37 GB / 31.92 GB\n Binaries:\n Node: 22.3.0 - C:\\Program Files\\nodejs\\node.EXE\n Yarn: 1.22.17 - ~\\AppData\\Roaming\\npm\\yarn.CMD\n npm: 9.8.1 - C:\\Program Files\\nodejs\\npm.CMD\n Browsers:\n Chrome: 138.0.7204.169\n Edge: Chromium (136.0.3240.92)\n Internet Explorer: 11.0.19041.5794\n npmPackages:\n vitepress: ^1.6.3 => 1.6.3\n```\n\n### Additional context\n\nTested on Chrome, Edge and Firefox - all have the same issue.\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.",[3190],{"name":3160,"color":3161},4865,"markdown :line-numbers","2025-07-29T22:58:24Z","https://github.com/vuejs/vitepress/issues/4865",0.68566895,{"description":3197,"labels":3198,"number":3200,"owner":3149,"repository":3150,"state":3151,"title":3201,"updated_at":3202,"url":3203,"score":3204},"### Describe the bug\n\nAccording to [the configuration option](https://vitepress.vuejs.org/config/app-configs.html#markdown) of the documentation, this option is enabled:\r\n\r\n```ts\r\n// .vitepress/config.ts\r\nexport default defineConfig({\r\n // ...\r\n markdown: {\r\n lineNumbers: true,\r\n },\r\n // ...\r\n})\r\n```\r\n\r\nNot getting the expected result showing line numbers , by the way, the code snippets of the documentation also have no line numbers:\r\n\r\n\r\n\r\n\n\n### Reproduction\n\n```ts\r\n// .vitepress/config.ts\r\nexport default defineConfig({\r\n // ...\r\n markdown: {\r\n lineNumbers: true,\r\n },\r\n // ...\r\n})\r\n```\n\n### Expected behavior\n\nShow the code line numbers.\r\n\r\n\r\n\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 Intel(R) Core(TM) i5-10400F CPU @ 2.90GHz\r\n Memory: 8.46 GB / 15.91 GB\r\n Binaries:\r\n Node: 16.15.0 - D:\\Programs\\nodejs\\node.EXE\r\n Yarn: 1.22.18 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.11.0 - D:\\Programs\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (103.0.1264.62)\r\n Internet Explorer: 11.0.19041.1202\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.4 => 1.0.0-alpha.4\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.",[3199],{"name":3146,"color":3147},1046,"markdown.lineNumbers doesn't work under default theme","2023-01-21T14:30:12Z","https://github.com/vuejs/vitepress/issues/1046",0.6860534,{"description":3206,"labels":3207,"number":3208,"owner":3149,"repository":3150,"state":3151,"title":3209,"updated_at":3210,"url":3211,"score":3212},"### Describe the bug\n\nI placed a `project.md` file in the public directory and want to link it in my markdown file to download it. I tried using the following markdown syntax:\r\n```\r\n[markdown file | download](/project.md){target=\"_self\" download}\r\n```\r\nHowever, after compilation, I noticed that the resulting HTML link was: \r\n```html\r\n\u003Ca href=\"/project.html\" target=\"_self\" download=\"\">markdown file | download\u003C/a>\r\n```\r\nSo, it seems that the link I set in my markdown page becomes an HTML page. \n\n### Reproduction\n\nJust see the \"Describe the bug\".\n\n### Expected behavior\n\nAfter compilation, the result should be as follows:\r\n```html\r\n\u003Ca href=\"/project.md\" target=\"_self\" download=\"\">markdown file | download\u003C/a>\r\n```\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.5\r\n CPU: (8) arm64 Apple M1\r\n Memory: 112.03 MB / 16.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.12.2 - /usr/local/bin/node\r\n npm: 10.5.0 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 125.0.6422.142\r\n Safari: 17.5\r\n npmPackages:\r\n vitepress: ^1.2.3 => 1.2.3\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.",[],3947,"Not support downloading local markdown file ","2024-06-16T04:41:53Z","https://github.com/vuejs/vitepress/issues/3947",0.68928504,{"description":3214,"labels":3215,"number":3220,"owner":3149,"repository":3150,"state":3151,"title":3221,"updated_at":3222,"url":3223,"score":3224},"### Describe the bug\r\n\r\nBuild blocking error happen on \"vitepress build docs\".\r\nWorks correctly and as intended on \"vitepress dev docs --port 8080\"\r\n\r\nTypeError: Failed to parse URL from [path]\r\n[cause]: TypeError [ERR_INVALID_URL]\r\n\r\n### Reproduction\r\n\r\nUse the regular Markdown File Inclusion with any file in any .md file, then try to build with \"vitepress build docs\".\r\n\r\nhttps://vitepress.dev/guide/markdown#markdown-file-inclusion\r\n\r\n### Expected behavior\r\n\r\nBuild concluding with success and no error displayed.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem: \r\n OS: Windows 10 10.0.19044 \r\n CPU: (4) x64 Intel(R) Core(TM) i5-7200U CPU @ 2.50GHz \r\n Memory: 1.94 GB / 7.62 GB \r\n Binaries: \r\n Node: 19.8.1 - C:\\Program Files\\nodejs\\node.EXE \r\n Yarn: 1.22.17 - ~\\AppData\\Roaming\\npm\\yarn.CMD \r\n npm: 9.5.1 - C:\\Program Files\\nodejs\\npm.CMD \r\n Browsers: \r\n Edge: Spartan (44.19041.1266.0), Chromium (111.0.1661.62)\r\n Internet Explorer: 11.0.19041.1566 \r\n npmPackages: \r\n vitepress: ^1.0.0-alpha.62 => 1.0.0-alpha.62\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n\r\n\r\n\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] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3216,3217],{"name":3160,"color":3161},{"name":3218,"color":3219},"stale","ededed",2180,"Markdown \"@include\" throw \"ERR_INVALID_URL\" on \"vitepress build docs\"","2023-08-11T00:04:15Z","https://github.com/vuejs/vitepress/issues/2180",0.6895018,{"description":3226,"labels":3227,"number":3228,"owner":3149,"repository":3150,"state":3151,"title":3229,"updated_at":3230,"url":3231,"score":3232},"### Is your feature request related to a problem? Please describe.\n\nI use vitepress to generate documentation for a GitHub project. The documentation will be generated locally and then pushed to GitHub. It is then deployed from the /docs folder to GitHub pages.\r\n\r\nEvery time I build the documentation the filenames in /assets will change. A filename looks for e.g. \"index.md.497bee00.js\". The part \"497bee00\" changes every time I build the documentation. As I must check it in in order to havbe the built documentation in my GitHub project, there are new filenames for each build. \n\n### Describe the solution you'd like\n\nUse filenames in /asset, that are not changing for each build.\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/coc)\n- [X] Read the [docs](https://vitepress.vuejs.org/).\n- [X] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/master/.github/contributing.md).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[],386,"Unique names for files in /assets","2023-01-21T16:22:04Z","https://github.com/vuejs/vitepress/issues/386",0.69354916,{"description":3234,"labels":3235,"number":3239,"owner":3149,"repository":3150,"state":3151,"title":3240,"updated_at":3241,"url":3242,"score":3243},"### Describe the bug\n\nHere is an example of the issue:\r\n\r\nDocs hierarchy is like this:\r\n```\r\n📦docs\r\n ┣ 📂.vitepress\r\n ┗ 📂lang\r\n ┣ 📂C++\r\n ┃ ┃ ┣ 📜index.html\r\n ┃ ┃ ┗ 📜links.html\r\n ┃ ┗ 📜index.html\r\n ┗ 📜index.md\r\n```\r\n\r\nIn my .vitepress/config.js :\r\n```js\r\nthemeConfig: {\r\n nav: [\r\n \u003CMY_NAV>\r\n ],\r\n sidebar: [ \r\n {\r\n text: 'LanguageExample',\r\n collapsible: true,\r\n items: [\r\n { text: 'Home', link: '/lang/'},\r\n { text: 'C++', link: '/lang/C++/'}\r\n ]\r\n },\r\n}\r\n````\r\n\r\nso the build failed with errors :\r\n> Error [ERR_MODULE_NOT_FOUND]: Cannot find module \u003CMY_PROJECT_PATH>\\docs\\.vitepress\\.temp\\lang_C++_index.md.js imported from \u003CMY_PROJECT_PATH>\\node_modules\\vitepress\\dist\\node\\serve-c2318085.js\r\n at new NodeError (node:internal/errors:372:5)\r\n at finalizeResolution (node:internal/modules/esm/resolve:437:11)\r\n at moduleResolve (node:internal/modules/esm/resolve:1009:10)\r\n at defaultResolve (node:internal/modules/esm/resolve:1218:11)\r\n at ESMLoader.resolve (node:internal/modules/esm/loader:580:30)\r\n at ESMLoader.getModuleJob (node:internal/modules/esm/loader:294:18)\r\n at ESMLoader.import (node:internal/modules/esm/loader:380:22)\r\n at importModuleDynamically (node:internal/modules/esm/translators:106:35)\r\n at importModuleDynamicallyCallback (node:internal/process/esm_loader:35:14)\r\n\r\n\n\n### Reproduction\n\n- Named a doc folder with \"+\" character in his name and put her name/path in custom sidebar links.\r\n- run `yarn docs:build`\r\n\n\n### Expected behavior\n\nSuccessful build when running yarn docs:build\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22000\r\n CPU: (20) x64 Intel(R) Core(TM) i9-10900K CPU @ 3.70GHz\r\n Memory: 10.89 GB / 31.92 GB\r\nBinaries:\r\n Node: 16.15.0 - E:\\Program_Files\\Node16\\node.EXE\r\n Yarn: 1.22.19 - ~\\AppData\\Roaming\\npm\\yarn.CMD\r\n npm: 8.6.0 - E:\\Program_Files\\Node16\\npm.CMD\r\nBrowsers:\r\n Edge: Spartan (44.22000.120.0)\r\n Internet Explorer: 11.0.22000.120\r\nnpmPackages:\r\n vitepress: ^1.0.0-alpha.19 => 1.0.0-alpha.19\n```\n\n\n### Additional context\n\nI don't know if this issue has already been reported, i just found [this](https://github.com/vuejs/vitepress/issues/1039) issue, and maybe the both are related.\r\n\r\nAnd yes, in my case i can just replace \"+\" characters with a \"P\" one, but, i think this issue can be interest to be fixed for other case.\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.",[3236],{"name":3237,"color":3238},"build","377ba8",1439,"Build fails when filename has special characters","2023-01-21T14:25:09Z","https://github.com/vuejs/vitepress/issues/1439",0.6963468,["Reactive",3245],{},["Set"],["ShallowReactive",3248],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fyi2GQBOyNXf2wLoc5fvqPl3vpJjf__wpifO8wmzlkyk":-1},"/vuejs/vitepress/3289"]