The Wire · Showcase
VITEPRESS ALPHA 19 SHIPS WITH GROUND-UP FILE INCLUSION REWRITE
By RepoJournal · Filed · About Vue.js
VitePress alpha 19 landed overnight with a structural overhaul of code snippets and markdown inclusion that fixes four long-standing bugs in one sweep.
The release [1] comes paired with a complete rewrite of the `<<<` code snippet and `<!-- @include: -->` markdown inclusion features onto a shared region engine [2]. The old regex-based parser silently swallowed metadata into file paths; the new structural parser cleanly separates `[title]`, `{meta}`, and `#region` markers so nothing gets lost in translation. This single rewrite fixes issues #3690, #4625, #4838, #5014, and #5207 [2]. Relative URLs inside included markdown files now resolve from the included file's location instead of the page including it [3], which means partials can link to their neighbors regardless of context. The docs have been updated to cover multi-region concatenation, region marker stripping, build errors for missing files, and line-range includes through fenced syntax [4]. Russian translation updates landed in parallel [5].
One email a day. Unsubscribe in one click.
Keep up with Vue.js in about 3 minutes a day: what actually shipped — the commits, pull requests, releases, and security advisories that matter.
One email a day. Unsubscribe in one click. Read a past issue →
Action items
- → Test code snippet and markdown inclusion in your docs before upgrading to stable vuejs/vitepress [plan]
- → Review relative URL behavior in included markdown if you use nested partials vuejs/vitepress [monitor]
References
- [1] v2.0.0-alpha.19 ↗ vuejs/vitepress
- [2] code snippet and markdown inclusion rewrite ↗ vuejs/vitepress
- [3] feat(markdown)!: rebase relative urls in included files vuejs/vitepress
- [4] docs: update code snippet and file inclusion guides vuejs/vitepress
- [5] docs(ru): update translations- #5296 ↗ vuejs/vitepress