我正在编写一个带有侧面笔记的在线教程，或者他们称之为“admonitions”，类似于Django教程中的那些： https://docs.djangoproject.com/en/dev/intro/tutorial01/（我的意思是带有绿框和注释图标的框。）
我应该使用哪个HTML标记来附加这些注释，以添加注释的语义含义，这对于在教程的给定点读取可能很有用，但不是主要教程流程的一部分？
值得注意的是，标签必须允许封闭块元素。
答案 0 :(得分：6)
我认为接受的答案并不完全正确。根据{{3}}，<aside>元素可用于标记某些但不是所有情况下的旁注：
<aside>是合适的，如果旁注“可以被视为与内容分开”，例如瑞士的背景材料更长的新闻报道，或者拉引号更长的文章。 （来自W3C文件的例子）<aside>不合适。 W3C没有提供它的含义的例子。狭义的解释是放在括号中，逗号之间或破折号之间的任何内容。如果您想严格解释W3C规范，并非HTML5 working draft中的所有旁注都可以用<aside>标记。例如，标题为“与您看到的内容不匹配？”的注释实际上不能被视为与内容分开，因为没有旁边的内容它没有意义。可以说，“此代码应该在哪里生效？”也不是<aside>，因为它提到了“此代码”，它将内容与内容联系起来。
在我看来，W3C的定义是不必要的混淆和限制。 旁边的字典定义是“暂时偏离主题或主题”，规范应该坚持这一点，而不是引入微妙的区别。当然，没有理由不能将<aside>用于所有侧注，如果它使您的代码更简单。将其视为公民不服从。 ：）
相关引用：
aside元素表示由页面组成的部分 与旁边内容相切的内容 元素，可以认为与该内容分开。 这些部分通常在印刷字体中表示为侧边栏。
该元素可用于印刷效果，如拉引号或 侧边栏，广告，导航元素组和其他 被视为与页面主要内容分开的内容。
注意：将旁边元素仅用于括号内是不合适的，因为它们是文档主流的一部分。
答案 1 :(得分：5)
在HTML5中（受所有现代浏览器支持），标记为aside。
来自http://www.whatwg.org/specs/web-apps/current-work/multipage/sections.html#the-aside-element：
aside元素表示由页面组成的部分 与旁边内容相切的内容 元素，可以认为与该内容分开。 这些部分通常在印刷字体中表示为侧边栏。
该元素可用于印刷效果，如拉引号或 侧边栏，广告，导航元素组和其他 被视为与页面主要内容分开的内容。
将旁边的元素仅用于括号内是不合适的， 因为这些是文件主要流程的一部分。
这是一个块级元素，通常可以包含任何块级元素（即几乎任何东西）。它本质上是一个“语义div”。