首页
/ Rspress v2.0.0-beta.9 版本发布:Markdown 处理优化与性能提升

Rspress v2.0.0-beta.9 版本发布:Markdown 处理优化与性能提升

2025-06-27 19:33:58作者:凌朦慧Richard

Rspress 是一个现代化的静态站点生成器,专为技术文档网站设计。它基于 React 和 Rspack 构建,提供了出色的开发体验和构建性能。本次发布的 v2.0.0-beta.9 版本主要聚焦于 Markdown 处理能力的增强和性能优化。

Markdown 处理能力增强

原生支持 HTML 标签解析

新版本默认启用了 rehype-raw 插件,这意味着开发者现在可以直接在 Markdown 文件中使用 HTML 标签而无需额外配置。这一改进显著提升了内容编写的灵活性,使得在文档中嵌入自定义 HTML 元素变得更加方便。

代码块元数据处理优化

团队对代码块的元数据处理逻辑进行了重构。之前版本中,prism 语法高亮和代码块元数据处理存在一些兼容性问题。新版本通过引入 shiki 兼容的 metastring 属性,确保了不同语法高亮方案下元数据的一致性处理。

空块引用容错处理

修复了一个当 Markdown 中包含空块引用(>)时导致编译器崩溃的问题。现在系统能够正确处理各种边缘情况的块引用语法,提升了文档编写的健壮性。

性能优化

虚拟模块重构

对虚拟模块系统进行了重要重构,移除了单独的 virtual-routes-ssr 模块,将其功能统一整合到 virtual-routes 模块中。这一改动简化了模块结构,减少了不必要的代码分割,提升了构建效率。

主题包构建优化

@rspress/theme-default 主题包现在采用了 bundleless 的 dist 结构。这种构建方式减少了不必要的打包步骤,使得主题包的体积更小,加载速度更快。

其他改进

动态目录排除功能增强

改进了动态目录(TOC)的生成逻辑,现在可以正确识别和排除带有 .rspress-toc-exclude 类名的祖先节点。这一改进使得开发者能够更精确地控制目录生成的范围。

错误处理增强

在静态生成(SSG)过程中,改进了 Suspense 边界内的错误处理机制,现在能够正确暴露被隐藏的错误堆栈信息,显著提升了调试体验。

总结

Rspress v2.0.0-beta.9 版本通过一系列 Markdown 处理能力的增强和性能优化,进一步提升了文档编写的体验和网站的运行效率。这些改进使得 Rspress 在处理复杂文档结构时更加可靠,同时也为开发者提供了更大的灵活性。对于技术文档网站的建设者来说,这个版本值得升级体验。

登录后查看全文
热门项目推荐