支持 Markdown 语法和代码高亮

最新推荐文章于 2025-04-08 12:28:09 发布

xiaoqingyu123

最新推荐文章于 2025-04-08 12:28:09 发布

阅读量1.7k

点赞数

分类专栏： https://www.zmrenwu.com/博客教程，自己的分析，复习

本文链接：https://blog.youkuaiyun.com/xiaoqingyu123/article/details/78902777

版权

https://www.zmrenwu.com/博客教程，自己的分析，复习专栏收录该内容

12 篇文章

订阅专栏

本文介绍如何在Django项目中使用Markdown渲染富文本，并实现代码高亮功能。通过安装Markdown和Pygments库，结合Django视图函数，对文章内容进行格式化处理。同时，解决HTML标签被转义的问题，确保正确显示。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文是根据大牛博客教程，自己的知识拾遗，记录。

Markdown 使用方式，将需要渲染的文本交给markdown处理一下即可

Markdown 的简单使用

pip install Markdown

blog/views.py

import markdown
from django.shortcuts import render, get_object_or_404
from .models import Post

def detail(request, pk):
    post = get_object_or_404(Post, pk=pk)
    # 记得在顶部引入 markdown 模块
    post.body = markdown.markdown(post.body,
                                  extensions=[
                                     'markdown.extensions.extra',
                                     'markdown.extensions.codehilite',
                                     'markdown.extensions.toc',
                                  ])
    return render(request, 'blog/detail.html', context={'post': post})

safe标签

我们在发布的文章详情页没有看到预期的效果，而是类似于一堆乱码一样的 HTML 标签，这些标签本应该在浏览器显示它本身的格式，但是 Django 出于安全方面的考虑，任何的 HTML 代码在 Django 的模板中都会被转义（即显示原始的 HTML 代码，而不是经浏览器渲染后的格式）。为了解除转义，只需在模板标签使用 safe 过滤器即可，告诉 Django，这段文本是安全的，你什么也不用做。在模板中找到展示博客文章主体的 {{ post.body }} 部分，为其加上 safe 过滤器，{{ post.body|safe }}，大功告成，这下看到预期效果了。

代码高亮

pip install Pygments

引入样式

<link rel="stylesheet" href="{% static 'blog/css/highlights/github.css' %}">