使用警告扩展。对于mkdocs，可以在mkdocs中配置。yml文件:

markdown_extensions:
    - admonition

然后在md文件中插入注释，如下所示:

!!! note

     This is a note.

这里有一个例子。

以下方法工作在GitHub，在GitLab…在Stackoverflow上，现在使用CommonMark!

>用Blockquote制作的一行盒子

用Blockquote制作的单行盒子

“用反划线制作的单行框”

单行盒与反刻度

' ' ' 盒子与三反tick ' ' '

Box made with Triple Backticks  

~ ~ ~ 用三个波浪线制作的盒子(删除波浪线之间的空间以使其工作) ~ ~ ~

Box made with Triple Tildes

每行开头有四个空格的方框:

    “Sometimes we must let go of our pride and do what is requested of us.”
    Padmé Amidala

．.． 还是用水平线?

三个破折号(——)组成一条水平线:

注意:“你的专注决定了你的现实。——奎刚·金。

对于更多的配置，我强烈推荐优秀的GitLab Markdown指南。 你也可以检查不太详细的GitHub基本格式语法。 您可以使用Babelmark比较Markdown实现。

有用提示:

要强制换行，在行尾放置两个空格; 要转义特殊字符，使用\。

使用GitHub，我通常会插入一个blockquote。

> **_NOTE:_**  The note content.

变得……

注:说明内容。

当然，总有简单的HTML…

这是一个简单的基于乳胶的例子。

---
header-includes:
    - \usepackage[most]{tcolorbox}
    - \definecolor{light-yellow}{rgb}{1, 0.95, 0.7}
    - \newtcolorbox{myquote}{colback=light-yellow,grow to right by=-10mm,grow to left by=-10mm, boxrule=0pt,boxsep=0pt,breakable}
    - \newcommand{\todo}[1]{\begin{myquote} \textbf{TODO:} \emph{#1} \end{myquote}}
---

blah blah

\todo{something}

blah

结果是:

不幸的是，因为这是latex，所以你不能再在TODO框中包含markdown(通常这不是一个大问题)，并且当转换为PDF以外的格式(例如html)时，它将不起作用。

你也可以使用https://www.npmjs.com/package/markdown-it-container

::: warning
*here be dragons*
:::

然后渲染为:

<div class="warning">
<em>here be dragons</em>
</div>

我通常在标记文本中放置警告框(例如，注意或警告)(不仅在使用pandoc时，而且在任何支持标记的地方)是用两条水平线围绕内容:

---
**NOTE**

It works with almost all markdown flavours (the below blank line matters).

---

大概是这样的:

NOTE

它适用于所有降价的口味(下面的空白行很重要)。

好消息是你不需要担心哪个降价风味是支持的，或者安装或启用了哪个扩展。

编辑:正如@filups21在评论中提到的，在RMarkdown中，一条水平线似乎是由***表示的。所以，之前提到的解决方案并不像最初声称的那样适用于所有廉价口味。