Fumadocs Editor

Known Limits

Engine differences, platform caveats, current boundaries

General

  • React 19 only. The editor is a client component; SSR apps mount it inside 'use client'. For a server-rendered first paint, pass your site's rendered MDX as staticFallback. The editor swaps in on hydration without a parse on the critical path.
  • Word pastes are coerced through the schema, so marks, tables and lists survive. One upstream exception: Word numbered lists arrive as literal 1. Item paragraphs. That is ProseMirror's clipboard parser.
  • Not yet editable: <CodeBlockTabs>, plain <Tabs> and footnotes are verbatim-only for now (details).

Collaboration

  • A hard kill of the sync server can lose edits still inside its save debounce (under a second). An orderly shutdown flushes.
  • Edits typed while the server was down are discarded when it comes back (restarts). Edits made while merely disconnected converge on reconnect.
  • The raw MDX tab is disabled during collab.

Last updated on

On this page