Skip to main content

5 posts tagged with "developer-tools"

View All Tags

How to Edit the Confluence Storage Format (And When You'd Need To)

· 7 min read
Who should read this
  • Confluence admins fixing broken pages, macros, or corrupted formatting
  • Developers migrating or bulk-editing page content via the storage format
  • Power users who need find-and-replace across a page's underlying XML
What you'll learn
  1. What the Confluence storage format is and why you'd edit it directly
  2. How to open the raw XML of a page and make safe changes
  3. Formatting, find-and-replace, and diffing changes before saving
  4. When editing storage format is the right tool (and when it isn't)

Most Confluence users never see it, but every page is stored as an XML document in Confluence's storage format — a specific XHTML dialect with custom tags for macros, layouts, and embeddings. The visual editor hides this. But sometimes the only way to fix a problem is to edit that XML directly: a macro is corrupted and won't render, a copy-paste introduced broken formatting, or you need to find-and-replace a URL across a long page that the visual editor can't reach.

Confluence exposes the storage format through its REST API, but there's no built-in visual editor for it. Raw Storage Source Editor for Confluence adds one — a Monaco-powered editor that opens the raw storage XML of any page, with format, find-and-replace, and (in the Pro edition) a diff view. This guide covers when and how to use it safely.

Write Markdown in Confluence With Mermaid, LaTeX & Code — One Editor, Live Preview

· 8 min read
Who should read this
  • Engineering teams who write docs in Markdown but live in Confluence
  • Research/academic teams who need LaTeX math equations inside wiki pages
  • Anyone tired of Markdown editors that drop Mermaid diagrams or render math as plain text
What you'll learn
  1. How to write Markdown in Confluence with a live split preview
  2. Embedding Mermaid flowcharts and ZenUML sequence diagrams inside Markdown
  3. Rendering KaTeX and full LaTeX (MathJax) math — inline, block, and fenced
  4. GitHub-flavored tables, 190+ code languages, and dark mode

The scenario every technical team hits: your engineering docs live in Markdown — READMEs, API references, design docs — and they contain diagrams (Mermaid), equations (LaTeX), and code samples. You paste that Markdown into Confluence, and it falls apart. The Mermaid code blocks render as plain text. The LaTeX equations show as raw $...$ syntax. The code blocks lose their syntax highlighting. Confluence's native editor is WYSIWYG, not Markdown, and the import tools treat Markdown as a one-time conversion rather than something you edit live.

Enhanced Markdown for Confluence solves this with a Markdown editor that renders everything inline — Mermaid diagrams, KaTeX and LaTeX math, syntax-highlighted code, and GitHub-flavored tables — with a live split preview. It runs on the Quikdown engine, so all rendering libraries are bundled locally (no external CDN dependencies, which matters for "Runs on Atlassian" compliance). This guide walks through writing Markdown in Confluence with diagrams, math, and code all rendering live.

Best Confluence Apps & Plugins in 2026 — Developer Tools Compared

· 5 min read

Developer teams use Confluence differently than marketing or HR. You document APIs, share architecture diagrams, write runbooks, and collaborate on code reviews. The default Confluence editor works, but it wasn't built for technical documentation.

This guide covers the best Confluence apps for developers in 2026, organized by use case. We built several of these apps at NGPILOT, so we'll be transparent about where our apps fit and where competitors offer better solutions.

Confluence Source Editor Compared — Free vs Pro

· 11 min read

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.

Confluence Code Block Themes — Dark Mode, Monaco Editor & 85+ Languages

· 5 min read

Confluence code block themes let you customize how code appears in your documentation. The built-in code macro offers limited theme support, but third-party apps bring dark mode, syntax highlighting, and VS Code-like editing to Confluence.

This guide compares the best Confluence code block apps for syntax highlighting, including Modern Code Blocks, Better Code Macro, and Prism Syntax Highlighter. Learn which one fits your team's needs for Confluence code block themes, language support, and developer experience.