> For the complete documentation index, see [llms.txt](/llms.txt).
> The full corpus is at [llms-full.txt](/llms-full.txt).

# Guides

> Step-by-step guides for working with the Portable Text Editor.

Practical guides for customizing and extending the Portable Text Editor.

### [Custom rendering](/editor/guides/custom-rendering/)

Change how the editor renders and styles text. Covers render props for blocks, spans, decorators, annotations, list items, placeholders, and range decorations.

### [Customize the toolbar](/editor/guides/customize-toolbar/)

Build custom toolbars using `@portabletext/toolbar` hooks. Covers decorator buttons, style selectors, keyboard shortcuts, undo/redo, and reflecting editor state.

### [Create a custom behavior](/editor/guides/create-behavior/)

Add custom behaviors to the editor. Walk through defining a behavior with events, guards, and actions, then registering it with `BehaviorPlugin`.

### [Behavior recipes](/editor/guides/behavior-cheat-sheet/)

Common solutions using the Behavior API: logging, auto-closing brackets, emoji pickers, and raising events.