Skip to main content

How to Set Up Announcement Banners in Jira (Rich Text, Scheduling & Targeting)

· 6 min read
Who should read this
  • Jira admins who need to broadcast maintenance windows, outages, or policy changes
  • IT/ops teams that want dismissible vs. persistent banner control
  • Anyone frustrated by Jira's plain-text native banner limitations
What you'll learn
  1. How to create a Jira announcement banner with rich text and emojis
  2. Choosing dismissible vs. persistent banners (and when each fits)
  3. Managing a library of announcements for quick reuse
  4. How this compares to Jira's built-in banner and to Confluence banners

The scenario every Jira admin hits: there's a maintenance window Saturday night, a security policy change, or an ongoing incident — and you need every person who opens Jira to see it immediately. Jira has a built-in announcement banner, but it's plain-text only, lives in a buried admin setting, and gives you one banner at a time with no library, no scheduling, and no way to let users dismiss it.

Modern Announcement Banner for Jira fixes this: rich-text banners with emojis and custom colors, a dismissible option, a saved library of announcements you can switch between with one click, and instant enable/disable without deleting. This guide walks through setting it up.

Whiteboarding Architecture Sessions in Jira & Confluence — From Sketch to Saved Diagram

· 7 min read
Who should read this
  • Engineering teams that sketch architecture during planning and design reviews
  • Tech leads who want design decisions captured on the ticket, not lost in a photo
  • Anyone comparing freehand whiteboarding vs. text-based (Mermaid) diagramming
What you'll learn
  1. How to run an architecture whiteboarding session that stays attached to the Jira epic
  2. When freehand sketching beats structured diagrams (and vice versa)
  3. Using 229 cloud/UML/networking shape libraries inside Jira
  4. How Excalidraw and Mermaid complement each other

Every architecture review ends the same way: the team sketches a system on a whiteboard, someone takes a blurry phone photo, and the diagram is never seen again. The next sprint a new engineer joins, asks how the system fits together, and the whiteboard gets redrawn from memory — different every time.

The fix is to capture the architecture sketch on the ticket it describes, editable by anyone on the team, versioned with the issue. That's what Excalidraw Diagrams plus Whiteboards for Jira does: it adds a full drawing canvas to every Jira issue, with 229 bundled shape libraries and freehand drawing. The same experience is available in Confluence via Excalidraw plus Whiteboards for Confluence. This guide walks through running an architecture session that produces a saved, shareable diagram.

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.

Manual Toggles vs Modern FAQ for Confluence — 3 Methods Compared

· 9 min read

FAQ pages are one of the most visited sections of any documentation site. In Confluence, they serve a specific purpose: giving your team or customers quick answers to the questions they ask most often, without making them read through pages of documentation. A well-structured FAQ page reduces repetitive questions in Slack channels, shortens onboarding time for new team members, and deflects support tickets before they are created.

But Confluence does not have a built-in FAQ feature. Teams typically resort to manual workarounds — tables, toggle macros, or expand sections — that look cluttered and are hard to maintain. This guide shows you three methods to create professional FAQ pages in Confluence, from a quick manual setup to a fully featured FAQ macro.

How to Set Up Announcement Banners in Confluence and Jira

· 7 min read

Announcement banners are the most visible communication channel in Atlassian products. They sit at the top of every page, impossible to miss. When you need to notify your entire organization about a maintenance window, a security alert, a policy change, or an upcoming event, banners guarantee visibility in a way that emails and Slack messages cannot.

Both Confluence and Jira support announcement banners, but their native implementations are limited. This guide covers how to set up banners in both platforms using built-in features and marketplace apps, with practical tips for getting the most out of them.

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.

JSON Formatting & Display in Confluence: Code Blocks vs Structure Viewer

· 4 min read

Confluence's native code block macro renders JSON as plain text with no real formatting, no themes, and no copy button. There are two purpose-built apps that fix this, and each serves a different JSON display need:

  • Modern Code Blocks for Confluence — renders JSON as syntax-highlighted code with the Monaco editor (VS Code engine), 50+ themes, line numbers, copy button, and dark/light mode. Best for API docs, snippets, and most JSON display.
  • JSON Structure Viewer for Confluence — renders JSON as an interactive collapsible tree you can zoom and rotate. Best for exploring large, deeply nested structures.

This guide compares the two so you can pick the right one for each page.