Lists

There are three types of lists supported by text notes:

  •  Bulleted lists (also known as unordered lists).
  •  Numbered lists (or ordered lists).
  •  To-do lists

For bulleted and numbered lists, it's possible to configure an alternative marker such as squares or Roman numbering by pressing the  icon. For numbered lists, it's also possible to specify the number to start at or whether to count in reverse order. On the Mobile Frontend, these are in the row of the List › button, which shows while the cursor is in a list; its List type button also turns the list into another kind, to-do lists included.

Keyboard interaction

  • To create a new list:
    • Bulleted list: Start a line with * or - followed by a space;
    • Numbered list: Start a line with 1. or 1) followed by a space;
    • To-do list: Start a line with - [ ] for an unchecked item or [x] for a checked item.
  • To create a new item in the list, press Enter.
  • To create a blank line within a list item, press Shift+Enter.
  • To exit out of the list, press Enter twice.
  • To merge two lists, simply delete the gap between them.
  • To create nested lists, simply use the  button (see Indentation in Other features) or the Tab key. To decrease the nesting level for the current element, press Shift+Tab.
  • The menu of the block handle, described in Formatting toolbar, has Insert item above, Insert item below and Insert child item, which add an empty item above the item, below it and its nested items, or as its first nested item.

Headings, code blocks within lists

It possible to add content-level blocks such as headings, code blocks, tables within lists, as follows:

1Article ImageFirst, create a list.
2Article ImagePress Enter to create a new list item.
3Article ImagePress Backspace to get rid of the bullet point. Notice the cursor position.
4Article ImageAt this point, insert any desired block-level item such as a code block.
5Article ImageTo continue with a new bullet point, press Enter until the cursor moves to a new blank position.
6Article ImagePress Enter once more to create the new bullet.

The same principle applies to all three list types (bullet, numbered and to-do).

Sorting

The items of a list can be sorted, nested items moving with the item they belong to. This is experimental, see Sorting.

Alignment

A list item can be centered or aligned to the right, either with the text alignment button in the formatting toolbar or by aligning the Tables cell that contains the list. The bullet, number or checkbox then moves together with the text of the item.

To-do lists

See To-do Lists.

Collapsible lists

Starting with Trilium v0.104.0, it is possible to collapse nested list items. This applies to bullet lists, numbered lists as well as to-do lists.

To collapse or expand a list item that has nested sub-items:

  • Using the mouse, move the cursor over the list item and an arrow will appear to its left. Clicking it will toggle between collapsed and expanded.
  • For bullet lists and numbered lists, it's also possible to click directly on the marker (e.g. the bullet or the number) instead of on the arrow to collapse or expand it. This won't work for to-do lists since this would toggle the to-do instead.
  • Press Ctrl+Alt+Enter which will toggle the collapse/expand state for the item at the cursor position.

Of note:

  • Collapsed items always show the arrow to indicate its state.
  • The collapsed state is saved at note level and synced across instances, which means that it will restore after a refresh or reopening of the application.
  • The collapsed state is also persisted in Import & Export, but only for the HTML format. Markdown exports will not preserve the collapse state.
  • Collapsible bullets only exist in the context of editable text notes. Read-only lists will always be fully expanded.
  • The list items will auto-expand on edit to avoid typing in a hidden area.