tiptap/docs/src/docPages/api/overview.md
2020-11-17 12:39:39 +01:00

1.1 KiB
Raw Blame History

Overview

tiptap is a friendly wrapper around ProseMirror. Although tiptap tries to hide most of the complexity of ProseMirror, its built on top of its APIs and we recommend you to read through the ProseMirror Guide for advanced usage.

Structure

ProseMirror works with a strict Schema, which defines the allowed structure of a document. A document is a tree of headings, paragraphs and others elements, so called nodes. Marks can be attached to a node, e. g. to emphasize part of it. Commands change that document programmatically.

Content

The document is stored in a state. All changes are applied as transactions to the state. The state has details about the current content, cursor position and selection. You can hook into a few different events, for example to alter transactions before they get applied.

Extensions

Extensions add nodes, marks and/or functionalities to the editor. A lot of those extensions bound their commands to common keyboard shortcuts.