60 posts tagged with "how-to"

Long pages die from scroll fatigue. Onboarding checklists, troubleshooting trees, API reference details, legal disclaimers — content that only some readers need some of the time is the canonical use case for collapsible sections. Confluence ships a native expand macro for exactly this, and for many pages it's enough.

This guide covers how the native expand works, where teams typically outgrow it, and what a styled accordion macro adds — so you can pick per page, not per vendor.

Tabs are the layout workhorse of product pages, API references, and comparison docs: they let one page hold three versions of the truth (per environment, per plan, per language) without tripling the scroll length. Confluence's answer to tabs has changed over the years, so this page sorts out what exists today and which to use when.

Developers, technical writers, and data scientists think in Markdown. READMEs, API docs, pull request descriptions, and design specs are all written in it. But Confluence — where most of that knowledge ends up living — has no native Markdown support. Pasting Markdown into the WYSIWYG editor produces broken tables, literal asterisks, and lost formatting. This guide walks through the options so you can pick the right Markdown approach for your team without trial and error.

Take a look at your most-visited Confluence page right now. Does it look like it belongs on the modern web — or does it look like internal documentation from 2015?

If your answer is the latter, you're not alone. Teams across thousands of Confluence sites tell us the same story: "I know exactly what I want my page to look like. I just can't make Confluence do it."

In this guide, we'll show you six concrete ways to level up your Confluence pages — from Medium-style reading layouts to interactive surveys — all without leaving your editor.

Code reviews happen in pull requests, but the decisions and context often get lost. When someone asks "why did we implement it this way?" the answer is buried in a closed PR with hundreds of comments.

Documenting code reviews in Confluence preserves this context. AI can automate the documentation, turning unstructured PR discussions into organized knowledge. This guide covers how to use AI for code review documentation.

Documentation quality degrades over time. Pages get outdated, formats drift, and gaps emerge as the team and product evolve. Manual review is time-consuming and often inconsistent.

AI can automate documentation review, identifying quality issues and improvement opportunities at scale. This guide covers how to use AI for Confluence documentation review, from audits to automated reports.

Sprint planning is part science, part guesswork. Teams estimate velocity based on gut feeling, leading to overcommitment or underutilization. AI can replace this guesswork with data-driven predictions.

This guide covers how to use AI for Jira sprint planning, from velocity prediction to scope recommendations.

Every new Jira issue needs decisions: What type is it? Who should work on it? How urgent is it? These decisions happen manually today, taking time and introducing inconsistency.

AI can automate these decisions by analyzing issue content, historical patterns, and team context. This guide covers how to use AI for Jira workflow automation, from triage to assignment.

Meetings are where decisions get made, but the notes rarely get written. Someone volunteers to take notes, gets distracted by the conversation, and the team leaves with fragmented memories and no clear action items.

AI meeting notes solve this by automatically capturing, transcribing, and summarizing meetings. This guide covers how to set up AI meeting notes in Confluence, from transcription to follow-up.

Confluence search is powerful but often frustrating. You know the information exists, but your search queries don't find it. Keywords miss synonyms, related content uses different terminology, and results bury the answer under irrelevant pages.

AI-powered search fixes this by understanding intent instead of just matching keywords. This guide covers how to use and optimize AI search in Confluence.