List item

The foundation node for both bullet and numbered lists with Word-compatible formatting.

Handles numbering, indentation, styling, and keyboard navigation for professional list creation.

Key features

Custom node view

The list item uses a custom node view that provides:

• Visual numbering/bullets - Rendered separately from content
• Smart indentation - Calculates proper spacing based on Word styles
• Font inheritance - Respects document and paragraph styles
• Marker alignment - Handles left, right, and centered numbering

Word compatibility attributes

The list item maintains numerous Word-specific attributes:

• numId - Links to Word numbering definition
• level - Tracks nesting depth (0-8)
• lvlText - Format string for numbering
• listNumberingType - decimal, upperRoman, lowerAlpha, etc.
• indent - Precise indentation values
• spacing - Line and paragraph spacing

OOXML Structure

<w:p>
  <w:pPr>
    <w:numPr>
      <w:ilvl w:val="0"/>
      <w:numId w:val="1"/>
    </w:numPr>
  </w:pPr>
  <w:r>
    <w:t>List item content</w:t>
  </w:r>
</w:p>

Keyboard shortcuts

Action	Shortcut	Description
New Item	Enter	Creates a new list item at the same level
Line Break	Shift+Enter	Adds a line break within the current item
Indent	Tab	Increases nesting level
Outdent	Shift+Tab	Decreases nesting level
Exit List	Enter twice	Creates a paragraph after the list

Numbering formats

Standard formats

• Decimal - 1, 2, 3, 4…
• Lower Alpha - a, b, c, d…
• Upper Alpha - A, B, C, D…
• Lower Roman - i, ii, iii, iv…
• Upper Roman - I, II, III, IV…

Custom formats

Word supports complex numbering like:

• Legal - 1.1, 1.2, 1.2.1, 1.2.2…
• Outline - I.A.1.a.i…
• Custom - Chapter 1, Section A, Article i…

Use case

• Document Structure - Organize content hierarchically
• Instructions - Step-by-step procedures
• Outlines - Multi-level document planning
• Legal Documents - Complex numbered sections
• Word Import/Export - Perfect numbering preservation

List item behavior is handled by the Paragraph extension. Lists in SuperDoc are paragraphs with numbering properties, matching how Word stores lists internally.

Keyboard shortcuts

Command	Shortcut	Description
(split item)	Enter	Split list item at cursor
(line break)	Shift-Enter	Add a line break within the current item
(indent)	Tab	Increase nesting level
(outdent)	Shift-Tab	Decrease nesting level

Numbering formats

Supported numbering formats from Word:

• Decimal — 1, 2, 3, 4…
• Lower alpha — a, b, c, d…
• Upper alpha — A, B, C, D…
• Lower roman — i, ii, iii, iv…
• Upper roman — I, II, III, IV…

Source code

View on GitHub →