Markdown 模板无法正确呈现 HTML

Question

我在我的 Django 网站中创建了一个 Markdown 过滤器。我使用了库markdown2。

虽然 HTML 会呈现，但它不会完全呈现它。 代码和语法亮点、URL 和列表无法正确呈现。

模板标签文件夹

文件名：ttags.py

from django.template import Library
import markdown2

register = Library()

@register.filter('markdown_to_html')
def markdown_to_html(markdown_text):
    htmlversion=markdown2.markdown(markdown_text)
    return htmlversion

模板文件

{% extends "layout.html" %}
{% load ttags %}
{% load static from staticfiles %}

{% block content %}

<div class="content">
{{ step.description | markdown_to_html | safe }}
</div>

{% endblock %}

提供的要渲染的文本如下

##### Usage of Variables

```python
name = "David"
age = 10
```

In the above example name and age are variables that store Text and Numbers respectively.

> Always remember to use Variables in your programs to store information.

渲染输出的 HTML 代码如下

<h5>Usage of Variables</h5>

<p><code>python
name = "David"
age = 10
</code></p>

<p>In the above example name and age are variables that store Text and Numbers respectively.</p>

<blockquote>
  <p>Always remember to use Variables in your programs to store information.</p>
</blockquote>

代码语法不显示在两行中

Answer 1

您需要启用fenced code blocks 扩展，这不是标准的 Markdown 功能。在您的过滤器定义中这样做：

htmlversion = markdown2.markdown(markdown_text, extras=['fenced-code-blocks'])

注意添加了extras 关键字参数传递给markdown2.markdown。如果您希望语法高亮也能正常工作，您需要安装 pygments 和相关 CSS 文件的副本以定义高亮样式。

我没有使用过 Markdown2 库的经验，也从未使用过。那么我怎么能确定这是正确的呢？注意围栏代码块：

```python
name = "David"
age = 10
```

被渲染到：

<p><code>python
name = "David"
age = 10
</code></p>

防护代码块的全部内容，包括语言标识符，都被包裹在一个内联代码跨度 (<p><code>) 中，而不是一个代码块 (<pre><code>)。这表明 Markdown 解析器将反引号解释为 code span，而不是代码块。由于防护代码块不是原始Markdown rules 的一部分，我们只能假设解析器和大多数解析器一样，默认情况下不支持防护代码块。事实上，对documentation 的快速检查表明，需要通过扩展启用受防护的代码块才能使其工作。