Markdown 如何在鹈鹕降价贴子的元数据部分写评论?

Markdown 如何在鹈鹕降价贴子的元数据部分写评论?,markdown,pelican,python-markdown,Markdown,Pelican,Python Markdown,在Pelican中,是否可以在标记文件的元数据部分添加注释?假设我有一篇类似这样的帖子: Title: Hello World! Tags: greetings Date: 2020-01-01 Lorem ipsum sit dolor amet... 是否可以向元数据添加注释?例如: Title: Hello World! Tags: greetings Date: 2020-01-01 # This is the first comment. # This is another co

在Pelican中,是否可以在标记文件的元数据部分添加注释?假设我有一篇类似这样的帖子:

Title: Hello World!
Tags: greetings
Date: 2020-01-01

Lorem ipsum sit dolor amet...
是否可以向元数据添加注释?例如:

Title: Hello World!
Tags: greetings
Date: 2020-01-01  # This is the first comment.
# This is another comment.

Lorem ipsum sit dolor amet...
上面的示例不起作用,因为鹈鹕将
#这是另一个注释。
视为降价标题

如何在Pelican标记文件的元数据部分进行注释?

对于标记内容,将处理委托给库。标记元数据由its处理,我认为its不支持元数据字段中的注释。粗略地检查一下,没有发现与这个问题有关的任何问题


简而言之,这个问题与Pelican本身无关,而是与依赖库有关。

使用HTML注释,或者将注释作为“官方”元数据。因此#1:


您可以使用许多Pelican插件来写入元数据部分,这(大部分)与Pelican默认期望的简单键-值元数据对向后兼容。这些YAML插件的示例包括:

在YAML中,注释以
#
开头(行中的任何位置,而不仅仅是开头),然后继续到行的末尾,就像您的示例中一样


你只需要记住几件事。首先,这些插件要求您以只包含
--
的行开始和结束整个元数据头,因此如果您正在转换现有Pelican站点,您可能需要编写一个简短的脚本(使用sed、Perl等)将这些分隔符添加到您的文件中。其次,YAML中的其他一些字符具有特殊含义,因此如果在元数据值中使用这些字符中的任何一个,则需要对其进行转义,或将这些值用单引号或双引号括起来。

作为Python Markdown的开发人员,我可以确认元数据中不支持注释。扩展本身不会将值的内容解析为降价,所以我不确定Pelican会采取什么额外的步骤来实现这一点。但是您可以尝试使用HTML注释。HTML注释可能有一个缺点:它们出现在HTML输出中。
Title: Hello World!
Tags: greetings
Date: 2020-01-01  # This is the first comment.
<!-- This is another comment. -->

Lorem ipsum sit dolor amet...
Title: Hello World!
Tags: greetings
Date: 2020-01-01  # This is the first comment.
Comment: This is another comment.

Lorem ipsum sit dolor amet...