A new way to write docs

We rebuilt the DeveloperHub editor from the ground up. Here is what is new, and why it makes writing and maintaining your documentation noticeably better.

The editor is where you spend your time in DeveloperHub, so it is the part we care about most. Over the years the old one had been patched and stretched well past what it was built for, and you could feel it: text that changed after you saved, formatting that arrived broken from other tools, undo that did not quite work.

So we replaced it. The new editor is built on a single, modern document model, and that one change fixes a whole category of long-standing frustrations while opening the door to features we simply could not build before. Everything you already have keeps working, and there is nothing you need to do.

Here is what changes for you.

What you save is what you keep

The number one complaint about the old editor was simple: what you saved was not always what came back.

- Underscores stay underscores. Type some_variable_name and it stays exactly that, instead of silently turning into italics.
- No more surprise stars. Stray `*` characters appearing after a save are gone.
- What you see on save is what you see on reload. Pages render the same way every time, with no drift between editing and viewing.
- Even unusual formatting saves cleanly. The old editor would occasionally choke on tricky content and mangle it. The new model handles it reliably.

It sounds like a small thing. In practice it removes that nagging "why did my page change after I saved it" moment for good.

Editing that just works

- Full undo and redo. Step backward and forward through your changes freely. Nothing is lost, even across complex edits.
- Paste from anywhere. Copying from Google Docs, Confluence, Notion, or any other tool now carries your formatting across far more faithfully. Headings, lists, tables, links, and emphasis come through intact instead of arriving as a wall of plain text or broken markup.
- A faster writing surface. Slash commands to insert blocks, an improved link toolbar, an image library, and quick pickers for variables and glossary terms make building a page quicker.

New and redesigned blocks

We added new building blocks and gave the existing ones a cleaner, more readable design in both light and dark themes.

- Blockquotes. A proper quote block for callouts, references, and emphasis. New in this release.
- A standalone code block. Alongside the existing code tabs for showing one example in several languages, you can now drop in a single code block in one step, with syntax highlighting across many languages, optional line numbers, and a wrap toggle.
- Richer tables. Tables are now a real layout tool. Merge cells to build the exact structure you need, turn the header row on or off, and colour and align individual cells.
- Aligned images. Position an image left, centre, or right so it sits exactly where you want within the flow of the page.
- Callouts without titles. Callouts no longer require a title. Use one for a quick note or tip without forcing a heading on top, and enjoy the refreshed icons and tints.

Everything else you rely on, including video, cards, synced blocks, audience-gated content, glossary terms, badges, and icons, carries over and looks better.

AI that writes with you

Our AI assistant is now fluent in the new editor.

- It edits your docs directly, in the same format you do, instead of working around the content.
- Changes show up inline. When the assistant proposes an edit, you see exactly what it added and removed, right in the page, so you can review and accept with confidence rather than guessing what changed.
- You stay in control. Accept or reject any change, and undo it like any other edit.

Because the editor and the assistant now speak the same language, expect AI features to get noticeably more capable from here.

Quietly better behind the scenes

Some of the biggest wins are the things you will simply stop worrying about.

- Comments that stay put. Comments now re-attach to the right place even after the surrounding text is edited, imported, or synced from GitHub.
- Clearer version history. Revisions and revert are built on the new model, so your history is accurate. The diff view is clearer too: it highlights exactly what text was added and removed, inline, instead of making you compare two whole versions side by side.
- Find and replace across a whole version. Sweep a change through every page in one pass.
- Lossless import and export. Round-trip your content to and from Markdoc and GitHub without losing structure.

Rolling out safely

We are turning this on project by project, with careful validation at every step, so the switch stays invisible. Your existing content is converted automatically and checked for fidelity before anything changes for your readers. There is no downtime, and no action needed on your side.

Why this matters

The old editor had reached its limits. Every new feature meant fighting the format. This new foundation lets us move faster and further, for the people writing your docs and the AI helping them. You get the reliability and the new blocks today, and this is the base we will build the next wave of improvements on.

Breaking Changes

- Darkdown (DeveloperHub.io Format, a superset of markdown) is no longer supported in imports, exports or API. The services now talk Markdoc fluently as the default language.
- Auto mode for linking page titles is no longer supported. Links must have a defined title.

Happy writing.