Skip to main content

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.

Import Markdown into Confluence — 3 Methods Compared (2026)

· 5 min read
Who should read this
  • Development teams importing GitHub READMEs to Confluence
  • Documentation engineers migrating Markdown file sets
  • Anyone who wants to write Markdown directly in Confluence
What you'll learn
  1. Comparison of three Markdown import methods
  2. How to choose the best tool for your use case
  3. Step-by-step setup instructions

Many teams have documentation in Markdown format (GitHub READMEs, API docs, developer guides) and need to bring it into Confluence. Confluence doesn't have a native Markdown import feature, but there are three ways to get Markdown content into Confluence pages.

Dark Mode for Confluence Code Blocks — Setup Walkthrough

· 4 min read

Confluence's built-in code block macro is limited — it supports roughly 30 languages, has no dark theme, and lacks basic features like copy buttons and collapsible sections. If your team writes documentation with code snippets, you need something better.

This guide shows how to add a VS Code-grade code editor to Confluence with syntax highlighting for 85+ languages, automatic dark/light theme detection, and one-click copy buttons.