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: