ProseMirror Module Arrives in Drupal: Structured JSON Editing for a Headless Future

Unlike traditional rich text editors in Drupal, which store content as HTML, the ProseMirror module stores it as structured JSON. While Drupal’s default editor, CKEditor 5, already outputs clean and structured HTML, HTML remains oriented toward web display. JSON, by contrast, aligns more naturally with API-first architectures, giving developers finer control over rendering, routing, and media behavior across platforms.

ProseMirror—the open-source framework that underpins this module—uses a schema-driven model to represent paragraphs, headings, links, and other semantic elements as typed JSON nodes. This makes it especially useful for decoupled or omnichannel contexts, where content must be delivered to mobile apps, static site generators, or email without being tied to HTML markup.

ProseMirror’s structured JSON model also draws distinctions when compared with other editing options in Drupal. Markdown Easy, by Mike Anello, gained notice after Dries Buytaert switched his blog to Markdown. Markdown offers a lightweight writing syntax and outputs HTML, appealing to authors who want minimal friction. But ProseMirror’s JSON-first approach offers more structure and flexibility for integration with APIs and frontends.

Visual editors like Mercury Editor and Gutenberg emphasize design and layout in the CMS. Mercury provides live previews and tightly integrates with Layout Paragraphs; Gutenberg brings WordPress’s block paradigm into Drupal with drag-and-drop components. These tools prioritize in‑CMS visual composition, whereas ProseMirror focuses on clean content structure for downstream use.

The Frontend Editing module, maintained by 1xINTERNET, complements the editorial toolbox by enabling inline editing via a sidebar panel on live pages. It doesn’t replace editors, but works with any configured editor — including ProseMirror, Markdown, or CKEditor — making it a useful workflow enhancer for minor edits.

Another project taking a deeper dive is EditTogether from Palantir. This is a collaborative, real-time editing framework for Drupal that works at the field level, enabling multiple users to work simultaneously. EditTogether builds on ProseMirror but extends it with commenting, change tracking, integration with Drupal’s workflow systems, and privacy controls — all while keeping data local and secure. While EditTogether builds on ProseMirror, it is not the same as the standalone ProseMirror module—it extends the framework into a full collaboration layer.

In the broader publishing workflow space, Pantheon Content Publisher from Pantheon offers a different angle: it lets authors work in Google Docs and publish directly to Drupal (or other platforms). This bridges the gap between editorial tools and CMS interfaces. While focused on ease and workflow convenience, ProseMirror is more about content modeling and backend integrity.

This release arrives at a pivotal moment. The UI Suite ecosystem is pushing low-/no-code design systems forward, integrating design artifacts, components, CSS variables, and theming in Drupal. With HTMX and Single Directory Components now in core, and the Experience Builder initiative developing a React-based visual editor known as Canvas, Drupal’s editorial and layout systems are converging toward a modular, dynamic future. ProseMirror positions itself as the structured content backbone in that evolving ecosystem.

The ProseMirror module integrates with Drupal’s existing infrastructure. It supports Linkit for entity references and offers a parser to convert CKEditor-generated HTML into its JSON format, making the migration path easier.

For more advanced cases, developers can define custom schemas, marks, and plugin behavior, extending both PHP and JS layers. In API-driven and decoupled setups, ProseMirror’s JSON output enables more precise caching, rendering, and integration than typical HTML-based editors.

The module is fully open source and operates independently. Its release marks a shift in Drupal’s editorial tooling — toward modular, structure-first authoring built for multi-platform publishing.