在任何一款现代程序语言中，注释都是至关重要的，它是源代码文件提升可读性的重要补充，也是多人协作时的重要工具。

Markdown 的注释可以通过三种方法实现：第一是通过 html 的 标记；第二可以通过样式隐藏段落内容，即 ；第三是通过 Markdown 自身的解析原理实现。

环境说明： 考虑到 Markdown 工具之间的不兼容，有的内容直接从页面复制粘贴到本地不会正常显示，大家学习时自己动手写是肯定没问题的。本节所有实例代码及演示效果均使用 Typora 工具完成。 本节所有截图均为 Typora 导出 HTML 后网页的渲染效果。

因为 Markdown 文档是基于 HTML 实现的，所以可以通过 HTML 原生对注释的支持实现文档注释效果。

实例 1：

其渲染结果如下：

其转换后的 html 的内容如下：

请注意：此种方法被注释的内容是不被渲染输出的。

这种方式原则上并不是注释，而是将内容隐藏，已达到注释效果。

实例 2：

其渲染结果如下：

其转换后的 html 的内容如下：

请注意：此种方法被注释的内容是会被渲染输出的，只是在输出时会被隐藏。

这种方法是利用了 Markdown 自身的语法，在 “超链接” 章节的内容中提到过可以通过 「中括号 []」 的方式定义全局超链接，而这种方式声明的内容不会被渲染成文字内容输出，因此达到了注释的效果。

实例 3：

其渲染结果如下：

其转换后的 html 的内容如下：

请注意：此种方法被注释的内容是不被渲染输出的。

写作者在书写文档的时候难免会出现无法一次完成的情况，这时候将草稿部分注释起来，可以让文章在不影响读者阅读的情况下保持持续更新。另一方面，Markdown 仍是一种编码语言，在使用过程中，尤其是团队协作过程中，我们可能需要一些特殊用法来实现想要的功能，那此时注释就非常适合作为代码说明。

实例 4：一段适合多人协作编辑的文档

其渲染结果如下：