Lists

Last updated May 2026

Basic Block

All plans

Two list block types — Bulleted List and Numbered List. Each block is a single list item. Multi-item lists are built by stacking consecutive list blocks of the same type.

Markdown shortcuts

Type this	Converts to
-	Bulleted List
*	Bulleted List
1.	Numbered List

Bulleted List

Renders a bullet character (•) on the left followed by a Tiptap editor for the item text. Add with /list or /bullet.

Numbered List

Renders a number followed by a period on the left. The number is stored in metadata.listIndex and defaults to 1. The block editor automatically increments listIndex for consecutive numbered list blocks so items count up correctly. Add with /numbered or /ol.

ℹ

List numbers are tracked per-block, not derived from DOM position. If you reorder numbered list items by drag-and-drop, the numbers update automatically to reflect the new order.

Keyboard behaviour

Enter

Creates a new list block of the same type immediately after the current item.

Enter (empty)

Pressing Enter on an empty list item converts it to a paragraph block and exits the list.

Tab

Increases the indent level of the item. Indented items are visually shifted right.

Shift+Tab

Decreases the indent level.

Backspace

Deletes the block when the cursor is at the start of an empty item.

Inline formatting

Both list types support the full inline formatting set — bold, italic, strikethrough, inline code, links, text color, and highlight. Select text to reveal the toolbar.

Text color

Applied to the entire item via the block-level color picker, or to individual words via the inline toolbar.

List index

Numbered list only. Stored as metadata.listIndex. Auto-incremented by the editor for consecutive numbered blocks.

Publishing

Each list item renders as a <div> with a bullet or number marker on the left and the Tiptap HTML on the right. Indented items receive left padding proportional to their indent level (indent × 2rem).

← PreviousHeadings Next →To-do