RemarkJS中的评论

时间:2016-12-14 13:15:33

标签: markdown remarkjs

是否可以在RemarkJS演示文稿的Markdown内容中添加内联注释?

在其他Markdown格式中,我使用[//]:(SOME_COMMENT)作为隐藏评论/标记的一种方式。备注是按字面意思显示。

我意识到我可以使用演讲者笔记,但对于我的用例,我希望能够用标识符注释Markdown的特定位。

1 个答案:

答案 0 :(得分:0)

使用原始HTML评论。

Standard Markdown没有特定语法的注释。[//]:(SOME_COMMENT)语法是非标准的,大多数实现都不支持(我从来不知道使用它的实现没有大量修改标准语法)

作为rules state

  

Markdown不是HTML的替代品,甚至不接近它。它的语法非常小,仅对应于HTML标签的一小部分。我们的想法不是创建一种语法,以便更容易插入HTML标记。在我看来,HTML标签已经很容易插入。 Markdown的想法是让阅读,编写和编辑散文变得容易。 HTML是一种发布格式; Markdown是一种写作形式。因此,Markdown的格式化语法仅解决可以用纯文本传达的问题。

     

对于Markdown语法未涵盖的任何标记,您只需使用HTML本身。没有必要为它添加前缀或分隔它以表明您正在从Markdown切换到HTML;你只需使用标签。

因此,一个简单的原始HTM评论会做到这一点:

<!-- SOME_COMMENT -->

<!--

    A multiline comment.

-->

请注意上述规则引用中的设计理念:“HTML是一种发布格式; Markdown是一种书写格式。”当你理解这一点时,那些经过严格修改的实现看起来就像Markdown之外的其他东西,你对Markdown是什么以及它能做什么产生了不同的期望。它设计简单,功能强大。