Rspress RSS插件支持HTML格式内容输出

Rspress作为一款现代化的文档工具，其内置的RSS插件为博客内容提供了订阅功能。然而当前版本中，RSS输出仅支持纯文本格式，这导致在RSS阅读器中无法正常显示文档中的HTML元素，如图片、代码块等富文本内容。

问题背景

在Rspack和Rsbuild等项目的官方文档站点中，博客内容通常采用Markdown格式编写，包含丰富的HTML元素。当这些内容通过RSS插件生成订阅源时，会经过htmlToText转换处理，将所有HTML标签去除，仅保留纯文本内容。这使得订阅者在RSS阅读器中无法获得与网页版相同的阅读体验。

技术实现分析

Rspress核心模块中的extractPageData.ts文件负责处理页面内容。当前实现中，通过htmlToText工具对HTML内容进行了转换处理，特别针对图片(img标签)和代码块(pre>code标签)等元素设置了skip格式，直接跳过了这些重要内容的输出。

解决方案

为了提供更好的RSS阅读体验，RSS插件需要支持HTML格式的内容输出。这可以通过以下方式实现：

1. 保留原始HTML内容：在生成RSS源时，不对内容进行htmlToText转换，直接输出包含HTML标签的完整内容。

2. 选择性保留HTML标签：可以根据需要配置保留特定的HTML标签，如img、pre、code等，同时过滤掉不必要的标签。

3. 提供格式选项：在插件配置中增加format选项，允许用户选择输出纯文本或HTML格式。

实现建议

在技术实现上，建议修改RSS插件的内容处理逻辑：

• 移除默认的htmlToText转换
• 提供cleanHtml选项，允许用户控制是否清理HTML
• 确保输出的HTML内容符合RSS规范
• 添加CDATA区块保护特殊字符

这种改进将使RSS订阅源能够完整呈现文档中的富文本内容，包括代码示例、图片等元素，大幅提升在RSS阅读器中的可读性和实用性。

预期效果

改进后的RSS输出将能够：

• 完整显示文档中的代码示例
• 正常呈现图片内容
• 保持与网页版一致的格式和排版
• 在各种RSS阅读器中获得更好的显示效果

这一改进对于技术文档类网站尤为重要，因为代码示例和图表往往是文档的核心内容。通过支持HTML格式的RSS输出，用户可以更方便地通过订阅方式获取完整的技术文档内容。