Skip to main content

Enhanced Markdown Setup Tutorial — Insert Macro, Modes & Publish

· 4 min read

Confluence Markdown support lets developers write documentation in their preferred format. This guide covers how to add Enhanced Markdown to Confluence for raw Markdown editing, WYSIWYG preview, tables, code blocks, and more.

Who should read this
  • Developers who prefer writing in Markdown
  • Technical writers needing to import Markdown files
  • Teams migrating from GitHub or other Markdown-based wikis
What you'll learn
  1. How to install and use Enhanced Markdown in Confluence
  2. Raw Markdown mode vs WYSIWYG mode
  3. Supported syntax: tables, code blocks, task lists
  4. Comparison with Confluence's native editor

Confluence Font Apps Compared: Google Fonts vs Custom Fonts Pro

· 11 min read

Confluence ships with a fixed set of system fonts. For most teams that works fine, but if your company has brand guidelines, an accessibility requirement for specific typefaces, or simply wants documentation that looks polished and professional, the default typography falls short.

The Atlassian Marketplace now offers several apps that let you use custom fonts on your Confluence pages. But with different feature sets, pricing models, and levels of maturity, choosing the right one takes more than a quick glance at star ratings.

This post compares the leading Confluence custom font apps side by side so you can make an informed decision for your team.

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.