如何将 Web 应用程序从 HTML 切换到 Markdown？

Question

我有一个 django 驱动的网站。 目前，所有文本字段都只是采用原始 HTML 的普通旧文本输入。 我没有漂亮的编辑器或任何东西。 我想开始使用 Markdown 和 WMD 让每个人的事情变得更容易。

我是否必须运行某种脚本来遍历数据库中的每个文本字段，以将所有 HTML 转换为 Markdown？ 如果我通过 markdown 过滤器运行 HTML，它在另一端的结果会相同吗？ WMD编辑器会从服务器读取HTML并将其转换为Markdown供用户编辑吗？

这里正确的做法是什么？

Answer 1

正如我在你的其他问题中提到的，使用 Markdown 时的一个好模式是将文本存储在数据库中的 markdown 和 html 格式。 这样，您就不需要每次查看页面时都转换为 html，并且可以轻松地在后台编辑原始 Markdown。

例如，博客应用程序可能有

class BlogPost(models.Model):

    ...

    body = models.TextField(help_text='Use Markdown syntax.')
    #field to store generated html
    body_html = models.Textfield(editable=False, blank=True)

    ...

    def save(self):
        body_html=markdown(self.body)
        super(BlogPost, self).save()

    ...

然后在模板中，您可以使用 {{body_html|safe}}。

我希望这能让您了解如何更改模型。 恐怕我没有关于如何处理遗留 html 数据的建议。

Answer 2

WMD 不做 Html-to-markdown，反之亦然； 您可以使用 html2text 将 HTML 转换为 Markdown。 默认情况下，WMD 仅使用您的第一个文本区域作为 Markdown 编辑器，但您可以覆盖它并添加预览 - 只需按照 WMD 附带的简单示例中的说明进行操作即可。 无论如何，API 正在发生变化（值得称赞的是，作者对此毫不神秘），因为整个事情都转向了更真正的开源概念，所以现在不值得详细解释它，也不值得尝试任何花哨的东西！ -)

Answer 3

显然，将旧的 HTML 转换为 Markdown 是完全没有必要的。 我将 django.contrib.markup.markdown 过滤器应用到我的模板中，并且遗留数据库记录中的 HTML 被直接传递。 非遗留记录中的 Markdown 也可以正确呈现。

当然，我的 Web 应用程序不允许用户修改这些字段，因此让 HTML 直接通过是可以的。 如果这是用户可编辑的字段，例如评论或维基，则此解决方案还不够。 您必须将安全参数传递给 Markdown 模板过滤器，这将删除所有 HTML，并且对于用 HTML 编写的旧帖子，需要进行一些 HTML 到 Markdown 的转换。

在这种情况下，另一个解决方案是编写一个新的模板过滤器来包装 Markdown 过滤器。 它将允许旧的 HTML 帖子通过，但将安全 Markdown 过滤器应用于非旧帖子。

Answer 4

使用已接受的答案时要小心。 默认情况下，标记文本不会删除不安全的标签。 恶意用户可以轻松插入 html，甚至可以插入脚本标签。 在模板中使用 {{body_html|safe}} 意味着执行用户的 html 或脚本。 自己尝试一下。