RemarkJS中的注释

Question

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

在其他Markdown格式中，我使用[//]:(SOME_COMMENT)作为一种具有不可见注释/标签的方式。Remark正在按字面显示这些内容。

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

Answer 1

使用原始HTML注释。

Standard Markdown没有注释，特定的syntax.The [//]:(SOME_COMMENT)语法是非标准的，并且不被大多数实现所支持(我从来没有听说过使用它的实现不会大量修改标准语法)。

作为rules state

HTML不是

的替代品，甚至不能接近HTML。它的语法非常小，只对应于HTML标记的很小的子集。这个想法并不是要创建一种使插入HTML标记更容易的语法。在我看来，HTML标签已经很容易插入了。Markdown的想法是让阅读、写作和编辑散文变得容易。HTML是一种发布格式；Markdown是一种书写格式。因此，Markdown的格式化语法只解决了可以在纯文本中传达的问题。

对于Markdown语法未涵盖的任何标记，只需使用HTML本身。不需要在它前面加上前缀或定界来表明您要从Markdown切换到HTML；只需使用标记即可。

因此，一个简单的原始HTM注释就可以做到这一点：

<!-- SOME_COMMENT -->

<!--

    A multiline comment.

-->

注意上面规则中引用的设计背后的哲学："HTML是一种发布格式；Markdown是一种书写格式。“当你理解了这一点，那么这些经过大量修改的实现看起来就像是Markdown之外的东西，你会对Markdown是什么以及它能做什么产生一套不同的期望。它是简单和功能轻的设计。