The note tag contains the text of one note. It must appear below a tag notes collection of annotations. The notes will be typeset as a unordered list below the documentation. (usually the descr node).
This means there is a limitation to the markup that a note can contain: It can just contain plain text with some markup, similar to what is allowed in li tags. No tables, lists or other structures are supported inside. Example:
<element name="TDuplicates"> <short>How to handle duplicates in a list</short> <descr> Some text </descr> <notes> <note>Be more explicit. Maybe refer to <link id="TStringList"/></note> <notes> </module>