Docs/The editor/Writing with blocks

Writing with blocks

The Nexus editor is a block-based rich text editor. Every piece of content — a paragraph, a heading, a checklist item — is its own block.

Basic editing

Click anywhere in a document to place your cursor and start typing. Pressing Enter creates a new paragraph block. Pressing Backspace at the start of an empty block deletes it.

Formatting text

Select any text to see the formatting toolbar. From there you can:

  • BoldCtrl+B / Cmd+B
  • ItalicCtrl+I / Cmd+I
  • Inline codeCtrl+E / Cmd+E
  • Links — Ctrl+K / Cmd+K
  • Strikethrough, highlight, and more from the toolbar

Block types

Nexus supports the following block types:

  • Paragraph — default text block
  • Headings — H1, H2, H3 (type # , ## , ### )
  • Bulleted list — type - or *
  • Numbered list — type 1.
  • Task list — checkboxes, type []
  • Code block — syntax-highlighted, type ```
  • Quote — type >
  • Callout — highlighted box for notes or warnings
  • Divider — horizontal rule, type ---
  • Table — see below
  • Image, Audio, File — upload or embed

Tables

Type /table to insert a table. Click any cell to edit. Use Tab to move between cells. Right-click a row or column to add, delete, or merge cells.

Drag to reorder

Hover over any block to see the drag handle (⠿) on the left. Drag it to move the block to a new position in the document.

Markdown shortcuts

The editor recognises common Markdown shortcuts as you type:

  • # → H1 heading
  • - or * → bulleted list
  • 1. → numbered list
  • [] → task list
  • > → quote block
  • --- → divider
  • ``` → code block
  • **bold** → bold
  • *italic* → italic