另一个解决方案是使用CSS邻接并使用h4(或更高):

#### note

This is the note content

h4 {
  display: none; /* hide */
}

h4 + p {
  /* style the note however you want */
}

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

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

变得……

注:说明内容。

当然，总有简单的HTML…

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

markdown_extensions:
    - admonition

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

!!! note

     This is a note.

这里有一个例子。

另一个解决方案是使用CSS邻接并使用h4(或更高):

#### note

This is the note content

h4 {
  display: none; /* hide */
}

h4 + p {
  /* style the note however you want */
}

对于同样的问题，我发现的最简单的解决方案是使用一个多行表，只有一行，没有标题(第一列是图像，第二列是文本):

----------------------- ------------------------------------
![Tip](images/tip.png)\ Table multiline text bla bla bla bla
                        bla bla bla bla bla bla bla ... the
                        blank line below is important 

----------------------------------------------------------------

另一种可能工作(PDF)的方法是使用Latex默认的fbox指令:

 \fbox{My text!}

或FancyBox模块获得更高级的功能(和更好看的盒子):http://www.ctan.org/tex-archive/macros/latex/contrib/fancybox。

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

---
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)时，它将不起作用。