Concepts
Learn about the building blocks of Portable Text and how the editor works.
The parts that make up the Portable Text Editor: schema, styles, decorators, annotations, lists, block objects, inline objects, and how they connect. Includes a glossary of common terms.
How node registrations own the editor’s markup, and how the engine dispatches between global, positional, and legacy renders.
Nest editable block content inside custom structures like callouts, code blocks, and tables, while the value stays plain Portable Text.
How behaviors work in the editor. Events, guards, and actions: the pattern that lets you customize how users interact with the editor.
Pure functions that answer questions about the editor’s value tree, given a path and a snapshot.
How copy and paste run through behaviors: the events in each direction and how several behaviors compose around the same clipboard.