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.

Usage

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.

Usage

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.

Usage

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

Source code