Django搭建个人博客：使用Markdown语法书写文章

最新推荐文章于 2025-10-09 21:51:14 发布

原创

最新推荐文章于 2025-10-09 21:51:14 发布 · 4.8k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#django #python

本文介绍了如何在Django博客中使用Markdown语法书写文章，并实现代码高亮。首先，通过安装Markdown库，让文章支持多种排版。接着，通过Django模板过滤器防止HTML转义，正确显示Markdown格式。然后，引入Pygments库生成代码高亮样式，提升代码展示效果。最后，总结了Markdown和代码高亮在Django博客中的应用。

上一章我们实现了文章详情页面。为了让文章正文能够进行标题、加粗、引用、代码块等不同的排版（像在Office中那样！），我们将使用Markdown语法。

安装Markdown

Markdown是一种轻量级的标记语言，它允许人们“使用易读易写的纯文本格式编写文档，然后转换成有效的或者HTML文档。建议读者一定要花五分钟时间熟悉一下Markdown的语法，熟练后码字效率一定会大幅提高。

关于Markdown语法看这里：Markdown 语法介绍

安装markdown也很简单：进入虚拟环境，输入指令pip install markdown即可。

使用Markdown

为了将Markdown语法书写的文章渲染为HTML文本，首先改写article/views.py的article_detail()：

article/views.py

...

# 引入markdown模块
import markdown

def article_detail(request, id):
    article = ArticlePost.objects.get(id=id)

    # 将markdown语法渲染成html样式
    article.body = markdown.markdown(article.body,
        extensions=