如果它在VS代码中，那么还有另一个好选项：

<span hidden> Some texts </span>

与“HTML注释标记”相比，它具有在编辑区域保持语法高亮显示的优势，以及为语义标记添加属性的能力，如＜span notice hidden＞。

警告：根据常识，不要在源代码中包含个人信息。

Vim Instant Markdown用户需要使用

<!---
First comment line...
//
_NO_BLANK_LINES_ARE_ALLOWED_
//
_and_try_to_avoid_double_minuses_like_this_: --
//
last comment line.
-->

这项小型研究证明并完善了马格努斯的答案

最独立于平台的语法是

(empty line)
[comment]: # (This actually is the most platform independent comment)

这两个条件都很重要：

使用#（而不是<>）注释前有空行。注释后的空行对结果没有影响。

严格的Markdown规范CommonMark仅适用于此语法（而不适用于<>和/或空行）

为了证明这一点，我们将使用Alexandre Mutel的Babelmark I。该工具检查大量Markdown实现上特定源代码的呈现。

（+-通过了测试，--没有通过，？-留下一些垃圾，这些垃圾在呈现的HTML中没有显示）。

无空行，使用<>13+15-注释前空行，使用<>20+，8-注释周围的空行，使用<>20+，8-没有空行，使用#13+1？14-注释前空行，使用#23+1？4-注释周围的空行，使用#23+1？4-带有3个连字符1+2的HTML注释？25-来自chl的答案（注意这是不同的语法）

这证明了上述陈述。

这些实现未通过所有7项测试。没有机会对它们使用excluded on render注释。

cebe/markdown 1.1.0cebe/markdown markdown额外1.1.0cebe/markdown GFM 1.1.0s9e\TextFormatter（Fatdown/PHP）

对于pandoc，一个阻止评论的好方法是使用yaml元块，正如pandoc作者所建议的那样。我注意到，至少在我的环境中（vim、vim-pandoc和vim-pandocsyntax），与许多其他建议的解决方案相比，这为注释提供了更恰当的语法高亮显示。

我将yaml块注释与html内联注释结合使用，因为html注释不能嵌套。不幸的是，在yaml元块中没有块注释的方法，所以每一行都必须单独注释。幸运的是，软包装的段落中应该只有一行。

在我的~/.vimrc中，我为块注释设置了自定义快捷方式：

nmap <Leader>b }o<Esc>O...<Esc>{ji#<Esc>O---<Esc>2<down>
nmap <Leader>v {jddx}kdd

我分别使用so、b和v注释和取消注释段落，作为我的<Leader>键。如果我需要注释多个段落，我将j，b映射到一个宏（通常为Q），然后运行＜段落数＞＜宏名＞（例如（3Q）。这同样适用于取消注释。

kramdown基于Ruby的markdown引擎，这是Jekyll的默认引擎，因此GitHubPages通过其扩展语法内置了注释支持：

{::comment}
This text is completely ignored by kramdown - a comment in the text.
{:/comment}

Do you see {::comment}this text{:/comment}?
{::comment}some other comment{:/}

这样做的好处是允许在线评论，但缺点是不能移植到其他Markdown引擎。

将注释放在非eval、非echo R块中怎么样？即。，

```{r echo=FALSE, eval=FALSE}
All the comments!
```

对我来说似乎很好。