Skip to main content

Confluence Source Editor Apps Compared: Free vs Pro

· 11 min read
NGPilot
NGPilot

Confluence stores every page as XML in a format called "Confluence storage format." Most users never see it. But if you have ever tried to fix a broken macro, remove hidden formatting artifacts, or bulk-edit repetitive markup, you know the rich text editor alone is not enough. You need direct access to the underlying source.

At NGPILOT, we built two apps for exactly this purpose: Raw Storage Source Editor for Confluence (free) and Raw Storage Source Editor Pro for Confluence (paid). Both let you open, view, and edit the raw XML behind any Confluence page. This post compares them feature by feature so you can pick the right one for your team.

Why Edit Confluence Storage Format Directly?

Confluence's storage format is an XML dialect based on XHTML with Confluence-specific elements like <ac:structured-macro>, <ri:page>, and <ac:parameter>. When you edit a page normally, the rich text editor generates this XML behind the scenes. Most of the time that works fine. But there are situations where the visual editor gets in the way:

  • Fixing broken macros. Sometimes a macro becomes corrupted and the visual editor refuses to render or save the page. Editing the XML directly lets you remove the offending element.
  • Removing invisible formatting. Copy-pasting from Word or Google Docs can inject stray inline styles, empty paragraphs, and nested <span> tags that bloat pages and break layouts.
  • Bulk find and replace. Need to update a URL that appears in 30 places across a long page? Search and replace in the source is faster than clicking through each macro.
  • Building advanced macros. Power users who construct complex macros, nested layouts, or custom HTML blocks benefit from seeing and editing the exact XML structure.
  • Migrating content. Teams moving content between spaces or instances sometimes need to manually adjust links, references, and macro parameters in the source.

If any of these sound familiar, a Confluence storage format editor is not a luxury — it is a necessity. The question is whether the free version is enough, or whether the Pro version's additional capabilities are worth it.

Raw Storage Source Editor for Confluence (Free)

The free version gives you straightforward, no-frills access to the raw storage format of any Confluence page. It is built on the Monaco editor — the same engine that powers VS Code — so it feels familiar to developers from the first keystroke.

How It Works

Open any Confluence page, click the "More actions" menu (the three-dot button), and select "Source Editor for Confluence." The full XML source of the page loads in a code editor. Make your changes and click Save. The page reloads with your edits applied.

Key Features

Format Document. Right-click in the editor and choose "Format Document" to automatically re-indent and tidy up the XML structure. This is useful when the storage format is a dense block of unformatted XML, which happens frequently with pages that have been edited many times or imported from other systems.

Command palette. Press F1, Ctrl+P (Windows/Linux), or Cmd+P (macOS) to open Monaco's command palette. This gives you access to the full set of editor commands — go to line, change encoding, toggle whitespace rendering, and more.

Lightweight and fast. The free version opens instantly and stays out of your way. It does one thing — show you the XML and let you edit it — and does it reliably.

What It Does Not Include

The free version is intentionally minimal. There is no diff view to compare your changes against the original, no editor theme options, and no dedicated search panel. If you need those capabilities, the Pro version adds them.

Raw Storage Source Editor Pro for Confluence (Paid)

The Pro version takes the same core experience — open a page's XML, edit it, save it — and wraps it in a professional-grade editing environment. It is still built on Monaco, but with significant enhancements that make it suitable for daily use by developers, system administrators, and technical writers.

How It Works

Same workflow: open a page, click "More actions," and select "Source Editor Pro for Confluence." The difference is what you see when the editor opens.

Key Features

Syntax highlighting and themes. The Pro version includes three editor themes: Light, Dark, and High Contrast. Click the palette icon in the top toolbar to switch. Your preference persists across sessions. The syntax highlighting makes XML elements, attributes, values, and CDATA blocks visually distinct, which dramatically improves readability on complex pages.

Diff View. This is the headline feature. As soon as you start editing, a "Diff View" button appears at the bottom-right of the window. Click it to open a side-by-side comparison: the left panel shows the original XML as it was when you loaded the page, and the right panel shows your current edits. You can continue editing on the right side while the diff is visible. This makes it easy to review exactly what you are changing before saving — critical when editing production pages where a wrong edit could break layouts or lose content.

Find panel. Click the search icon in the top toolbar or press Ctrl+F / Cmd+F to open a dedicated Find panel. In normal edit mode, it searches the full document. In Diff View, it searches the modified (right) side. Combined with Monaco's built-in replace functionality, this makes bulk edits fast and safe.

Toggle word wrap. Long lines of XML are common in Confluence storage format, especially in macro parameters and inline styles. The word-wrap toggle in the toolbar lets you switch between wrapped and unwrapped modes. In Diff View, word wrap is automatically disabled so that differences align cleanly between the two panels.

Format Document. Same as the free version — right-click and select "Format Document" to re-indent and tidy the XML. If the XML structure is invalid, formatting may fail — fix the errors first and then try formatting again.

Full Monaco command palette. Like the free version, pressing F1, Ctrl+P, or Cmd+P opens the command palette. The palette exposes Monaco functionality such as advanced search and replace with regex support, go to line, go to symbol, toggle minimap, render whitespace characters, and more. Most Monaco features work inside the editor.

Save and Cancel with safety guards. The Save button is disabled when there are no changes, when the editor is still loading, or when a save is already in progress. This prevents accidental double-saves and ensures you only write back to Confluence when you intend to. Cancel closes the editor without saving any changes.

Feature Comparison

FeatureFreePro
View raw Confluence storage format (XML)YesYes
Edit raw XML and save back to pageYesYes
Format Document (XML re-indentation)YesYes
Monaco editor engineYesYes
Command palette (F1 / Ctrl+P / Cmd+P)YesYes
Syntax highlighting with XML-aware coloringYes (Monaco-based)Yes (Monaco-based)
Editor themes (Light / Dark / High Contrast)NoYes
Diff View (side-by-side original vs. edited)NoYes
Dedicated Find panelNoYes
Toggle word wrapNoYes
Regex search and replaceYes (via command palette)Yes (via command palette)
Minimap navigationYes (via command palette)Yes (via command palette)
Go to line / symbolYes (via command palette)Yes (via command palette)
Invalid XML warning before formattingFormatting fails if invalidFormatting fails if invalid
Save button safety guards (disabled states)Yes
Theme preference persisted across sessionsNoYes
PriceFreePaid

When to Use Each

Choosing between the free and Pro versions comes down to how often you edit storage format and how complex those edits are.

Use the Free Version If...

  • You only need occasional access. If you open the source editor once a month to fix a broken macro or remove some stray formatting, the free version is all you need.
  • Your edits are simple and targeted. Removing a single broken element, changing a URL in one place, or checking what XML the visual editor generated — these tasks do not require diff views or themes.
  • You are evaluating whether you need a source editor at all. The free version is a zero-risk way to test the workflow. Install it, try it on a test page, and see if editing storage format fits into your team's process.
  • Budget is the primary constraint. Small teams and individual users who cannot justify a paid app for occasional use.

Use the Pro Version If...

  • You edit storage format regularly. System administrators, template builders, and developers who frequently work with the source XML will benefit from syntax highlighting, themes, and the diff view every single session.
  • You need to review changes before saving. The Diff View is invaluable when editing production pages. Seeing exactly what changed — side by side with the original — prevents costly mistakes.
  • You perform bulk edits with search and replace. The dedicated Find panel plus regex support in the command palette makes it fast to update URLs, macro parameters, or class names across an entire page.
  • You build or maintain Confluence templates. Template authors who construct complex layouts with nested macros need precise control over the XML. Syntax highlighting and minimap navigation help you understand the structure at a glance.
  • You migrate content between spaces or instances. Large-scale content migrations often require manual adjustments to links, page references, and macro configurations. The Pro version's diff and search capabilities make this manageable.
  • Your team includes non-developers who edit source. The themes, word wrap, and formatted XML make the source less intimidating for technical writers and content managers who are not used to reading raw XML.

Real-World Scenarios

Here are concrete examples of when each version shines.

Scenario 1: Removing a broken macro. A user reports that a page will not load in edit mode. You suspect a corrupted macro. You open the free source editor, find the macro element in the XML, delete it, and save. The page works again. Time: two minutes. The free version handles this perfectly.

Scenario 2: Cleaning up pasted content. A 50-page spec document was pasted from Google Docs into Confluence. The page is bloated with inline styles, empty paragraphs, and nested spans. You open the Pro editor, use Format Document to make the XML readable, then use regex find and replace to strip out the unwanted formatting. Diff View lets you verify the cleanup before saving. The Pro version saves you significant time here.

Scenario 3: Updating links after a space rename. After renaming a Confluence space, dozens of internal links on a key page still reference the old space key. You open the Pro editor, use search and replace to update all references at once, then check Diff View to confirm only the links changed. This would be tedious and error-prone in the free version.

Scenario 4: Debugging a custom macro. You are building a User Macro and need to see exactly what XML it generates. The free version lets you inspect the output quickly. For ongoing development where you iterate on the macro and check results repeatedly, the Pro version's theme support and syntax highlighting reduce eye strain.

A Note on Safety

Editing Confluence storage format is powerful. A single wrong character can break a page's layout or cause macros to fail. Both apps include the Format Document feature to help you keep the XML well-structured. The Pro version adds an extra layer of safety with Diff View — you always see what will change before you commit.

Regardless of which version you use, we recommend:

  • Test on a copy first. Duplicate the page, edit the copy, verify it renders correctly, then apply the same edit to the original.
  • Use Format Document before editing. Reformatted XML is easier to read and harder to accidentally break.
  • Keep backups. If your Confluence instance has page history enabled, you can always revert. Confirm this is turned on for critical pages.

Get Started

Both apps are available on the Atlassian Marketplace. Install the free version to get started immediately, or go straight to Pro if you know you need the advanced features. You can always start with free and upgrade later — the workflow is identical, so there is no learning curve when you switch.

Have questions about which version fits your team? Reach out to us at service@ngpilot.com — we are happy to help.