如果您正在使用Jekyll或octopress，下面的操作也会起作用。

{% comment %} 
    These commments will not include inside the source.
{% endcomment %}

Liquid标记｛%comment%｝首先被解析，并在MarkDown处理器到达它之前被删除。访问者在尝试从浏览器查看源代码时将看不到。

我编写了一个小awk程序来过滤添加到文本中的#omitbegine和#omitend标记。我使用awk将其输出通过管道传输到pandoc可以处理的临时文件。像这样：

awk-f省略过滤器.awk aim2_article.md>aim2_aArticle_tmp.md

pandoc--pdf engine=xelatex--lua filter=pagebreak.lua--filter pandoc crossref--citeproc aim2_article_tmp.md-o aim2_aarticle.pdf

这里是省略筛选器.awk：

/#omitbegin/ {
    insideOmit = 1;
}

! insideOmit {
    print $0
}

/#omitend/ {
    insideOmit = 0;
}

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

最独立于平台的语法是

(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）

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引擎。

我使用标准的HTML标记，例如

<!---
your comment goes here
and here
-->

注意三点划线。其优点是，在生成TeX或HTML输出时，它可以与pandoc一起工作。有关更多信息，请访问pandoc讨论组。

另一种方法是将注释放在样式化的HTML标记中。这样，您可以根据需要切换它们的可见性。例如，在CSS样式表中定义注释类。

.注释｛display:none；｝

然后，以下增强的MARKDOWN

我们不支持评论

在浏览器中显示如下

我们支持评论