5.3.19 note : Notes/Annotation entry.

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>  
Some text  
<note>Be more explicit. Maybe refer to <link id="TStringList"/></note>  

See also: notes (195), li (184)