在网站内容运营中，我们经常需要发布包含图片、链接、段落样式等丰富格式的文章。安企CMS（AnQiCMS）作为一款功能强大的内容管理系统，其灵活的模板引擎能够帮助我们轻松展示这些内容。然而，在享受便捷的同时，我们也必须关注一个核心问题：如何在模板中安全地输出这些带有HTML标签的文章内容，既保持其原有的精美格式，又能有效防范潜在的跨站脚本（XSS）攻击？
安企CMS采用类似Django的模板引擎语法，这在设计之初就考虑到了安全性。默认情况下，模板引擎会对所有输出的内容进行自动转义。这意味着，如果文章内容中包含像<script>这样的HTML标签，它们并不会被浏览器解析为可执行的代码，而是被显示为纯文本，例如<script>。这种机制极大地降低了XSS攻击的风险，因为它阻止了恶意脚本在用户浏览器中执行。
然而，这种默认的自动转义机制对于我们通过富文本编辑器创作的、带有合法HTML标签的文章内容来说，可能会带来困扰。例如，你在编辑器中加粗了文字，或者插入了一张图片，如果这些HTML标签被转义，最终用户看到的将是原始的、未格式化的HTML代码，而不是预期的视觉效果。
为了解决这个问题，安企CMS提供了|safe过滤器。当你确定某段内容是经过信任且安全的HTML时，可以通过在模板变量后添加|safe过滤器，明确告诉模板引擎：这段内容是安全的，请不要对其进行转义，直接按照HTML格式输出。
例如，在展示文章详情时，通常会这样使用：
<div>
{%- archiveDetail articleContent with name="Content" %}
{{articleContent|safe}}
</div>
在这里，archiveDetail标签用于获取文章的详细内容，name="Content"指定了获取文章主体内容字段。接着，{{articleContent|safe}}中的|safe过滤器就发挥了作用，它确保了articleContent变量中包含的所有HTML标签，如<p>, <strong>, <img>等，都能被浏览器正确解析并渲染，从而完整地保留了文章的排版和样式。
此外，如果您的内容是使用Markdown编辑器撰写的，并且您希望模板引擎将其自动渲染为HTML，archiveDetail标签还提供了render参数。例如，{% archiveDetail articleContent with name="Content" render=true %}{{articleContent|safe}}会先将Markdown内容转换为HTML，然后再通过|safe过滤器安全地输出。如果您希望保留原始的Markdown格式而不进行渲染，则可以将render设置为false。
理解|safe过滤器的作用至关重要。它相当于一个“信任声明”。一旦使用了|safe，模板引擎就会完全信任这段内容，不会再进行任何安全检查。因此，仅在您确信内容来源是可靠、受控，且经过严格审核的情况下，才应该使用|safe过滤器。
例如，来自安企CMS后台由编辑人员手动输入的文章内容，通常可以视为信任来源。因为后台的用户具有管理权限，并且富文本编辑器本身也会对一些常见的恶意脚本进行初步过滤。但是，如果您的网站允许用户提交内容（如评论、论坛帖子），或者您通过内容采集功能从外部抓取内容，那么在将其保存到数据库之前，务必进行严格的服务器端清理和消毒。安企CMS虽然提供了敏感词过滤等安全机制，但这主要是在内容存储层面的保障，输出时的|safe依然是您抵御XSS攻击的最后一道防线。
简而言之，在使用安企CMS模板展示包含HTML标签的文章内容时，核心策略是在信任的内容上使用|safe过滤器来保留格式，并在所有其他非信任内容上保持警惕，或在入库前进行彻底的清理。这样才能在内容展示的丰富性和网站安全性之间取得完美的平衡。
常见问题（FAQ）
问：为什么我的文章内容中的HTML标签没有生效，而是直接显示出来了？ 答：这通常是因为安企CMS模板引擎的默认安全机制在起作用。为了防止XSS攻击，模板引擎默认会对所有输出内容进行自动转义，将HTML标签显示为纯文本。如果您确定这些HTML标签是合法的、安全的，并且希望它们能正常渲染，您需要在输出该内容时使用
|safe过滤器，例如{{ archive.Content|safe }}。问：如果我的内容是从外部采集的，如何确保它在模板中安全显示？ 答：对于外部采集的内容，存在较高的XSS风险。即便安企CMS提供了内容采集功能，我们也强烈建议您在内容入库（保存到数据库）之前，通过自定义逻辑或第三方库对HTML内容进行严格的服务器端清理和过滤，移除所有潜在的恶意脚本和不安全的标签属性。避免直接将未经清洗的采集内容与
|safe过滤器一同使用。问：我正在使用Markdown编辑器，
|safe过滤器还需要用吗？ 答：是的，即使您使用Markdown编辑器，|safe过滤器通常也是必要的。当您在archiveDetail标签中使用render=true参数将Markdown内容转换为HTML后，为了让这些转换后的HTML标签正常渲染而非被转义，您仍然需要紧随其后使用|safe过滤器。例如：{% archiveDetail articleContent with name="Content" render=true %}{{articleContent|safe}}。