The table caption is written just above the top left corner of the table, and is repeated on every part-page if the table spans more than one page wide. Typically it would be used as a page-label for any higher dimensions where the report was paging through data such as sales by country by product:

:for ct :in ¼½prodname
  nltCaption prodname[ct]
  nltList prodsales[ct;;]
:endfor

If you pass a vector of captions they are stacked vertically above the table. You can change the caption font with CFont and the colour with CColour. Captions are always left-aligned at the head of the table.

See also table heading, subhead and footnote for other ways of adding text elements to tables.