在网站内容呈现中，文本的格式化往往是决定用户阅读体验的关键。我们经常会遇到这样的需求：从后台数据库中获取的文本内容，通常只包含简单的换行符（\n），如果直接将其显示在网页上，浏览器并不会智能地将这些换行符转换为我们期望的HTML段落（<p>）或换行（<br>）标签，导致内容挤在一起，失去原有的结构和可读性。

安企CMS（AnQiCMS）在模板设计上充分考虑了这一点，它提供了一系列便捷的内置过滤器，能够帮助我们轻松地将纯文本中的换行符转换为标准的HTML标签，确保内容在前端页面上自然、美观地呈现。这些过滤器就像是智能的格式化工具，只需简单调用，就能让复杂的文本排版问题迎刃而解。

核心机制：理解 AnQiCMS 的文本处理过滤器

安企CMS的模板引擎采用了类似Django的语法，其核心优势之一就是灵活的“过滤器”功能。过滤器允许我们对变量输出的内容进行修改和格式化。针对换行符的转换，AnQiCMS主要提供了 linebreaks 和 linebreaksbr 这两个过滤器，它们各自适用于不同的文本格式化需求。

1. linebreaks 过滤器：智能分段与行内换行

当我们处理的文章、长篇描述或评论等内容，期望它们在网页上能像传统文本一样，自动分段（即有空行的地方形成新段落），并且段落内部的换行能被保留时，linebreaks 过滤器是理想的选择。

linebreaks 的工作原理如下：

  • 将连续的两个换行符（\n\n）转换为HTML的段落标签 <p>...</p>。 这意味着在原始文本中，如果你通过连续两次回车创建了一个空行，linebreaks 会将其识别为一个新的段落。
  • 将单个的换行符（\n）转换为HTML的换行标签 <br>。 如果你只是在段落内部按了一次回车，希望内容在下一行继续，但不想开始一个全新的段落，linebreaks 会为其添加一个 <br> 标签。

举个例子，假设后台传入的文本内容 item.description 如下：

这是一段产品描述。
产品特点一。
产品特点二。

这是另外一段说明。
请注意相关事项。

在模板中，你可以这样使用 linebreaks 过滤器来输出：

{{ item.description|linebreaks|safe }}

这里，|safe 过滤器至关重要。因为它告诉模板引擎，经过 linebreaks 处理后的内容是安全的HTML，不需要再进行默认的HTML实体转义（比如把 <p> 转义成 &lt;p&gt;），从而确保浏览器能正确解析并渲染这些HTML标签。

经过这样的处理，最终网页上渲染出的HTML结构会是： “`html

这是一段产品描述。
产品特点一。