Paragraph extension

The foundation of document structure. Paragraphs support extensive styling including spacing, indentation, borders, and Word styles.

OOXML Structure

<w:p>
  <w:pPr>
    <w:jc w:val="center"/>
    <w:spacing w:before="240" w:after="120"/>
    <w:ind w:firstLine="720"/>
    <w:pBdr>
      <w:bottom w:val="single" w:sz="4" w:space="1" w:color="auto"/>
    </w:pBdr>
  </w:pPr>
  <w:r>
    <w:t>Paragraph content</w:t>
  </w:r>
</w:p>

Use case

Document structure - Basic building blocks of content
Formatting control - Spacing, alignment, indentation
Style application - Heading styles, body text styles
Borders & shading - Visual separation and emphasis
Keep with next - Control page breaks between paragraphs

Commands

`toggleBulletList`

Convert selected paragraphs to a bullet list, or remove list formatting if already a bullet list.

editor.commands.toggleBulletList()

import { SuperDoc } from 'superdoc';
import 'superdoc/style.css';

const superdoc = new SuperDoc({
  selector: '#editor',
  document: yourFile,
  onReady: (superdoc) => {
    const editor = superdoc.activeEditor;
    editor.commands.toggleBulletList()
  },
});

`toggleOrderedList`

Convert selected paragraphs to an ordered list, or remove list formatting if already an ordered list.

editor.commands.toggleOrderedList()

import { SuperDoc } from 'superdoc';
import 'superdoc/style.css';

const superdoc = new SuperDoc({
  selector: '#editor',
  document: yourFile,
  onReady: (superdoc) => {
    const editor = superdoc.activeEditor;
    editor.commands.toggleOrderedList()
  },
});

`restartNumbering`

Reset list numbering for the current list item and following items.

editor.commands.restartNumbering()

import { SuperDoc } from 'superdoc';
import 'superdoc/style.css';

const superdoc = new SuperDoc({
  selector: '#editor',
  document: yourFile,
  onReady: (superdoc) => {
    const editor = superdoc.activeEditor;
    editor.commands.restartNumbering()
  },
});

Keyboard shortcuts

Command	Shortcut	Description
toggleOrderedList()	`Mod-Shift-7`	Toggle ordered list
toggleBulletList()	`Mod-Shift-8`	Toggle bullet list
(split paragraph)	`Enter`	Split paragraph at cursor
(line break)	`Shift-Enter`	Insert line break without list properties
(indent)	`Tab`	Increase list indent level
(outdent)	`Shift-Tab`	Decrease list indent level

Input rules

Trigger	Result
`-` , `+` , or `*` at line start	Create bullet list
`1.` (or any number) at line start	Create ordered list

​OOXML Structure

​Use case

​Commands

​toggleBulletList

​toggleOrderedList

​restartNumbering

​Keyboard shortcuts

​Input rules

​Source code