Django邮件通知系统无法渲染HTML标签，求问题原因

问题原因 #

1. HTML标签被自动转义：Django模板默认会对变量中的HTML特殊字符（如<、>）进行转义，将其转换为HTML实体（如<、>），导致标签直接显示而不被浏览器渲染。
2. 换行符不生效：HTML语法中\n不会自动解析为换行，需要转换为<br>标签才能生效，同时Django模板默认不会处理这类换行转换逻辑。

解决方法 #

修改邮件模板 #

将模板中的{{body}}替换为带过滤器的写法，同时处理转义和换行需求：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{subject}}</title>
</head>
<body>
    {{ body|linebreaks|safe }}
</body>
</html>

• |safe：告诉Django该变量内容是可信的HTML代码，跳过自动转义流程，让浏览器正常解析标签。
• |linebreaks：将文本中的\n转换为HTML的<br>标签，同时会将连续换行的段落用<p>标签包裹；如果只需要简单换行不需要段落结构，可以用|linebreaksbr替代。

特殊场景说明 #

如果你的instance.message本身已经包含完整的HTML结构（比如自带<p>、<br>等标签），仅需保留{{ body|safe }}即可，无需添加linebreaks过滤器，避免重复转换导致格式混乱。

内容的提问来源于stack exchange，提问作者Sushi Wolf