如何使 django 的 markdown 过滤器将回车符转换为 ？

Question

如何更改 markdown 过滤器中的默认行为，以便将换行符转换为 br 标记？

Answer 1

我不认为搞乱换行语法是一个好主意......

我同意 Henrik 的评论。来自 markdown 文档：

当您确实想使用 Markdown 插入
中断标记时，可以用两个或多个空格结束一行，然后输入 return。

是的，这需要更多的努力来创建
，但简单地说“每个换行符都是
” 规则不适用于 Markdown。当您使用硬中断来格式化 Markdown 的电子邮件样式块引用和多段落列表项时，效果最佳，而且看起来更好。

您是否看过其他 Django 标记选项、纺织和重组文本？它们的语法可能更适合您。

---

但如果你仍然想...

一个粗略且现成的方法是链接 markdown 和 linebreaksbr 过滤器。

{{ value|markdown|linebreaksbr }}

这会运行 markdown 过滤器，然后运行 ​​linebreaksbr 过滤器，它将 \n 替换为
。您可能会遇到太多的换行符，但这可能比太少的换行符对您更好。

如果您有更好的解决方案，您可以

1. 编写一个自定义过滤器，正如约翰在他的回答中建议的那样。

2. 深入了解 Django 使用的 python-markdown 库，以及< a href="http://www.freewisdom.org/projects/python-markdown/Writing_Extensions" rel="nofollow noreferrer">编写一个扩展来实现您所需的换行语法。然后，您可以将扩展与过滤器一起使用

   {{ value|markdown:"linebreakextension" }}

Answer 2

编辑：截至 2011 年 6 月底，以下扩展现已包含在 Python Markdown 中。

这是我编写的 Markdown 扩展，目前正在我的网站上进行测试，以完全满足您的需求：

"""
A python-markdown extension to treat newlines as hard breaks; like
StackOverflow and GitHub flavored Markdown do.

"""
import markdown


BR_RE = r'\n'

class Nl2BrExtension(markdown.Extension):

    def extendMarkdown(self, md, md_globals):
        br_tag = markdown.inlinepatterns.SubstituteTagPattern(BR_RE, 'br')
        md.inlinePatterns.add('nl', br_tag, '_end')


def makeExtension(configs=None):
    return Nl2BrExtension(configs)

我将其放入名为 mdx_nl2br.py 的文件中，并将其放在我的 PYTHONPATH 中。然后，您可以在 Django 模板中使用它，如下所示：

{{ value|markdown:"nl2br" }}

如果您想在常规代码中使用它，您可以执行如下操作：

import markdown
md = markdown.Markdown(safe_mode=True, extensions=['nl2br'])
converted_text = md.convert(text)

这是文档中使用和编写扩展的起点。

Answer 3

您可以通过在 extras 设置中添加 "break-on-newline": True 来覆盖默认的 MARKDOWN_DEUX_STYLES：

MARKDOWN_DEUX_STYLES = {
    "default": {
        "extras": {
            "code-friendly": None,
            "break-on-newline": True,
        },
        "safe_mode": "escape",
    }
}

python-markdown2 的文档：

break-on-newline：将单个换行符替换为
确实如此。

Answer 4

您可以编写一个调用 markdown 的 自定义过滤器，然后对其输出进行替换。

Answer 5

似乎有一个 linebreaks 过滤器，可将 \n 字符转换为
或

>.
请参阅 换行 或 linebreaksbr。