Skip to main content
Create numbered lists with automatic sequencing. Full support for nested lists, custom numbering styles, and Word list definitions.

​
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 text</w:t>
  </w:r>
</w:p>

​
Use Case

  • Instructions - Step-by-step procedures
  • Legal documents - Numbered clauses and sections
  • Outlines - Hierarchical document structure
  • Requirements - Enumerated specifications
  • Nested lists - Multi-level organization with a, b, c or i, ii, iii

​
Options

Configure the extension behavior:
​
itemTypeName
string
default:"listItem"
Name of list item node type
​
htmlAttributes
Object
HTML attributes for ordered list elements
​
keepMarks
boolean
default:"true"
Whether to preserve marks when creating lists
​
keepAttributes
boolean
default:"false"
Whether to preserve attributes
​
listStyleTypes
Array<string>
default:"['decimal','lowerAlpha','lowerRoman']"
Available list style types

​
Attributes

Node attributes that can be set and retrieved:
​
order
number
default:"1"
Starting number for the list
​
sdBlockId
string
Block identifier for tracking
​
syncId
string
Synchronization identifier
​
listId
string
List identifier
​
list-style-type
string
default:"decimal"
List style type (decimal, lowerAlpha, lowerRoman)
​
attributes
Object
Additional attributes

​
Commands

​
toggleOrderedList

Toggle ordered list formatting
Converts selection to ordered list or back to paragraphs
Example: 
editor.commands.toggleOrderedList()

​
restartListNodes

Restart list node numbering
Resets list numbering for specified nodes
Example: 
editor.commands.restartListNodes(nodes, position)
Parameters:
​
followingNodes
Array
required
Nodes to restart
​
pos
number
required
Starting position

​
updateOrderedListStyleType

Update ordered list style type based on nesting level
Cycles through decimal -> lowerAlpha -> lowerRoman based on depth
Example: 
editor.commands.updateOrderedListStyleType()

​
Keyboard Shortcuts

CommandShortcutDescription
toggleOrderedList()⌘/Ctrl-Shift-7Toggle ordered list

​
Source Code

⌘I