哪个语义HTML标记用于显示旁注和警告？

我正在写一篇在线教程，其中有一些旁注，或者他们称之为“警告”，类似于Django教程中的内容： （我指的是带有绿色边框和便笺图标的方框）

我应该使用哪个HTML标记来封装这些注释，以添加注释的语义，这些注释在教程的给定点上可能有用，但不是主要教程流程的一部分

值得注意的是，标签必须允许包含块元素。

在HTML5（所有现代浏览器都支持）中，标签是

旁边的

发件人：

aside元素表示页面的一部分，该部分由
与侧边周围内容切向相关的内容
元素，可以将其视为与该内容分离。
在印刷版式中，这些部分通常表示为边栏

该元素可用于打印效果，如拉引号或
侧栏，用于广告、导航元素组和其他
被认为与页面主要内容分离的内容

仅在插入语中使用aside元素是不合适的，
因为这些是文档主要流程的一部分

这是块级元素，包含块级元素通常可以包含的任何内容（即几乎所有内容）。它本质上是一个“语义div”。
我认为公认的答案并不完全正确。根据，可以将
标记为
。例如，标题为“与您看到的内容不匹配”的便笺实际上不能被视为与内容分开，因为如果没有旁边的内容，它就没有意义。可以说，“此代码应该存在于何处？”也不是一个
，因为它提到了“此代码”，它将其与内容联系起来

在我看来，W3C的定义是不必要的混乱和限制。字典对“旁白”的定义是“暂时偏离主题”，规范应该坚持这一点，而不是引入微妙的区别。当然，如果
可以使代码更简单，那么就没有理由不使用
进行所有的旁注。将其视为公民不服从


相关报价：

aside元素表示页面的一部分，该部分由
与侧边周围内容切向相关的内容
元素，可以将其视为与该内容分离。
在印刷版式中，这些部分通常表示为边栏

该元素可用于打印效果，如拉引号或
侧栏，用于广告、导航元素组和其他
被认为与页面主要内容分离的内容

注意：仅对插入语使用aside元素是不合适的，因为它们是文档主流程的一部分

一个更好的描述是在它本身。当源代码写得这么好的时候，为什么还要读第二个注释呢？警告是一个附加语，正如你在回答中引用的那样，它不是一个适当的使用
的旁白
，因此，如果一个人试图按照他们的意图使用HTML5元素，这个答案是错误的。@Inigo我尊重地不同意你的评估。您引用的引用是“仅将旁白元素用于插入语是不合适的，因为它们是文档主流程的一部分。”但是OP明确表示，他们正在为“在教程的给定点阅读可能有用的注释，但不属于主教程流的一部分”寻找语义元素. 这就是“搁置”的目的。这不是主要内容流的一部分。@BenLee看看OP中的Django警告示例链接到了什么。它们不能“被视为与该内容分离”（引自HTML规范），因为它们不能独立存在——它们是与直接围绕的内容相关的附加插入。它们是流的一部分，因为它们在周围内容中的位置是重要的，而不是任意的；你不能把它们搬到别的地方去。想一想任何文档中的警告：它在流程中的位置非常重要。请参阅。链接的示例与OP所描述的不匹配，因此存在不一致性。为什么使用XHTML？嗯，也许我应该至少指定HTML版本——但如果能同时知道HTML4和5的解决方案，那就太好了。因为，正如Ben Lee所回答的，xhtml对于此类内容没有语义标记，其中html5有=）的定义：“与讨论的主要主题不直接相关的评论或讨论”，以及“演讲或文本中不属于主要主题的评论或故事”。我相信HTML规范与这些权威定义非常一致。最新版本的似乎没有标题为“与您看到的不匹配”和“此代码应该存在于何处？”的引用注释。以下是一个版本：