在Django Markdown中使用模板标签失效问题排查求助

问题场景 #

• Markdown版本：Markdown==3.2.1
• 渲染逻辑：博客模板details.html通过{{ post.body|markdown }}渲染文章内容
• 异常表现：在文章正文中写入包含Django模板标签的HTML代码（如<img src="{% static '/img/image.jpg' %}" alt="image">），渲染后模板标签未被解析，直接以文本形式显示

原因分析 #

Django模板过滤器的执行顺序是先处理markdown过滤器，将Markdown内容转换为HTML字符串，之后不会再对输出的HTML字符串重新扫描解析模板标签。也就是说，markdown过滤器的输出是纯静态HTML，Django不会识别其中的{% static %}这类模板语法。

解决方法 #

方法1：视图层先解析模板标签，再转Markdown #

在views.py中先通过Django模板引擎解析文章内容里的模板标签，再进行Markdown转换：

from django.template import Template, Context
import markdown
from .models import Post

def post_detail(request, pk):
    post = Post.objects.get(pk=pk)
    # 先解析内容中的模板标签
    template = Template(post.body)
    # 传入包含static等变量的上下文
    context = Context({'request': request})
    parsed_content = template.render(context)
    # 将解析后的内容转为Markdown格式
    post.body = markdown.markdown(parsed_content)
    return render(request, 'details.html', {'post': post})

模板中直接渲染处理后的内容，并用safe过滤器标记为安全HTML：

{{ post.body|safe }}

方法2：自定义模板过滤器，合并解析与转换 #

创建自定义过滤器，一次性完成模板标签解析和Markdown转换：

1. 在应用目录下创建templatetags文件夹，新建custom_filters.py：

from django import template
from django.template import Template, Context
import markdown

register = template.Library()

@register.filter(name='markdown_with_template')
def markdown_with_template(value, context):
    # 解析模板标签
    template = Template(value)
    rendered_content = template.render(Context(context))
    # 转换为Markdown
    return markdown.markdown(rendered_content)

2. 在模板中加载并使用该过滤器：

{% load custom_filters %}
{{ post.body|markdown_with_template:request|safe }}

注意事项 #

• 如果博客支持用户投稿，直接解析模板标签存在XSS攻击风险，需对用户输入做严格内容过滤
• 使用safe过滤器时，必须确保最终输出的HTML内容是可信的，避免恶意代码注入

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