Skip to main content

120 posts tagged with "confluence"

View All Tags

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.

How to Write Markdown in Confluence — Syntax, Tables & Code Blocks

· 13 min read
Who should read this
  • Developers and tech writers who want to write Markdown in Confluence instead of the WYSIWYG editor
  • Teams migrating README files, docs repos, or API references into Confluence
  • Anyone who needs Mermaid diagrams or LaTeX math inside Markdown content
What you'll learn
  1. Whether Confluence supports Markdown natively (and why it doesn't)
  2. How to write Markdown with live preview, including code blocks, tables, and Mermaid
  3. How Markdown content behaves after publish (search, exports, permissions)
  4. When to use Markdown vs. Confluence's native WYSIWYG editor

Confluence's built-in editor is strictly WYSIWYG — there is no native Markdown editor. For teams who already write in Markdown (README files, docs repos, pull request descriptions), that means manually reformatting every doc through toolbar buttons, losing time and introducing inconsistencies. Enhanced Markdown for Confluence solves this by embedding a full Markdown editor with live split preview directly inside Confluence — and it renders Mermaid diagrams, KaTeX/LaTeX math, and 190+ code-highlighted languages, all in one macro.

This FAQ answers the questions teams ask most often about writing Markdown in Confluence.

Mermaid Sequence Diagrams in Confluence: FAQ & Examples

· 17 min read

Sequence diagrams are one of the most widely used diagram types in software documentation. They show exactly how participants -- users, services, databases, external APIs -- exchange messages over time. For Confluence teams, embedding sequence diagrams directly on wiki pages means architecture docs, API specifications, and incident post-mortems stay in one place instead of scattered across external tools.

Mermaid's text-based syntax makes sequence diagrams fast to write and easy to update, but the syntax has its own set of rules that can trip you up. This FAQ answers the questions Confluence users ask most often about building sequence diagrams with Mermaid, with expanded explanations, working code examples, and copy-paste templates you can drop straight into a Mermaid Plus macro.

Confluence Page Navigation FAQ: TOC, Numbered Headings & Structure

· 15 min read

Page navigation is one of those things that nobody notices when it works well and everyone complains about when it does not. In Confluence, where pages routinely grow to thousands of words — technical specifications, onboarding guides, compliance documentation, project charters — helping readers find the right section quickly is not a nice-to-have. It is the difference between a knowledge base that people use and one that people ignore.

FAQ: Widget Carousel for Confluence — Image Sliders, Banners & Dashboards

· 15 min read

Confluence pages are powerful containers for knowledge, documentation, and team collaboration. But when it comes to displaying visual content -- product screenshots, event photos, marketing banners, or process walkthroughs -- the standard page layout falls short. Images stacked vertically create long, scroll-heavy pages that are difficult to scan, and Confluence's built-in gallery macro only offers a static thumbnail grid with no interactive slideshow behavior.

Widget Carousel for Confluence solves this by adding a fully interactive image carousel macro that you can embed on any Confluence page. You select images from page attachments or upload new ones directly, then display them in a customizable slider with configurable width options. The result is a polished, professional-looking carousel that transforms how visual content is presented in your Confluence workspace.

This FAQ covers the most common questions teams have about Widget Carousel for Confluence -- from basic setup and content types to advanced configuration, responsive design, and how it compares to Confluence's native gallery macro. Whether you are building a company dashboard, a project landing page, or a team portal, this guide will help you get the most out of the carousel.

Running Design Whiteboarding Sessions in Confluence — Why We Picked Excalidraw over draw.io

· 13 min read

When teams need to add diagrams to Confluence, two tools come up again and again: Excalidraw and draw.io (also known as diagrams.net). Both are popular Confluence diagram apps on the Atlassian Marketplace, but they take fundamentally different approaches to visual communication — and picking the wrong one wastes time and licensing budget.

The short version: for live whiteboarding, brainstorming, and freeform sketching, Excalidraw wins. For formal, finalized diagrams (UML, network topology, BPMN), draw.io is the better fit. Most teams end up needing both — and the rest of this post is the honest, feature-by-feature comparison so you can make the right call for your workflow.

Who should read this
  • Product/design teams deciding between Excalidraw and draw.io for whiteboarding
  • Eng leads choosing a diagramming tool for architecture sketches and UML
  • Anyone comparing the two for freeform vs structured diagramming