Django开发个人博客网站——15、通过markdown实现博客内容的展示

到现在我们已经可以实现很多功能了，包括登陆后台写博客，前端博客的展示、归档、标签云等等。但是直到现在我们的博客是没有样式的，所有的文字顺序排列，很不美观。如何才能实现博客的排版呢？还好有很多文字编辑器，我们可以使用最简单也是应用很广泛的，markdown语法。

什么是markdown语法，我们的CSDN、简书、博客园等都是用的markdown语法。它规则很简单，可以参考如下资料：

• Markdown——入门指南
• Markdown 语法说明 (简体中文版)

1、安装markdown

进入虚拟环境：

pip install markdown

2、渲染 Markdown

将 Markdown 格式的文本渲染成 HTML 文本非常简单，只需调用这个库的 markdown 方法即可。我们书写的博客文章内容存在 Blog的 content属性里，回到我们的详情页视图函数，对Blog 的 content的值做一下渲染，把 Markdown 文本转为 HTML 文本再传递给模板：

view.py

import markdown

# 将博客内容用markdown显示出来
blog.content = markdown.markdown(blog.content)

这样我们在模板中展示 {{ blog.content }} 的时候，就不再是原始的 Markdown 文本了，而是渲染过后的 HTML 文本。

blog-detail.html

{{ blog.content|safe }}

Django 出于安全方面的考虑，任何的 HTML 代码在 Django 的模板中都会被转义（即显示原始的 HTML 代码，而不是经浏览器渲染后的格式）。为了解除转义，只需在模板标签使用 safe 过滤器即可，告诉 Django，这段文本是安全的，你什么也不用做。

这样，再次刷新页面，就可以看到带有样式的博客页面了。

3、给主页添加上样式

我们这里只是给博客详情页面加上了markdown样式，但是我们博客的主页还有博客内容的展示。因此，也需要给博客主页的index.html添加上样式：

view.py

class IndexView(View):

    def get(self, request):
        all_blog = Blog.objects.all().order_by('-id')

        for blog in all_blog:
            blog.content = markdown.markdown(blog.content)
        ....

因为得到的是个queryset，因此需要用for循环对每个对象进行markdown样式的渲染。

最后要说明的是，对于我们不经常用markdwon语法的人，直接在后台书写markdown毕竟还是不太习惯的，并且没有实时预览。还有一点就是图片的插入我们暂时是实现不了的，因为这个功能需要将图片上传到云盘中，获得图片链接后再插入到博客内。为了简单操作，建议大家可以下载一个markdown编辑器，写好后直接粘过去就行了。让然，也可以像我一样，直接在csdn博客上书写，完事粘过去就可以了。

——————————————————————————————————————————

项目的完整代码：django_blog
觉得有用的欢迎给个star。