Diff

Shows two blocks of text side by side with the changes between them highlighted.

Put a before-and-after pair on a page, an old and new config block, two versions of a paragraph of policy wording, a snippet before and after a refactor, and let readers see exactly what changed rather than reading both and comparing by eye. You paste the two versions into the macro's Before and After boxes and it renders a two-pane CodeMirror merge view with insertions and deletions marked. It is a static comparison of text you supply, not a comparison of Confluence page versions or of attachments. Both panes are read-only for readers, so there is no risk of someone editing the comparison in place.

Typing /diff offers the macro in the insert menu alongside the other Capable entries.

#See it

Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up.

Two short JSON snippets side by side under a heading reading change description, with a line reading train added and highlighted on the right.
Both versions sit side by side with the changed lines marked, so readers can see what moved without reading every line.

#Diff, as configured on a real page

Agile development is a process that emphasizes
iterative work sequences. These work sequences
are known as sprints, and they are used to improve
the development workflow. Agile is ideal for teams
looking to adapt quickly to changes and ensure
customer satisfaction.
Agile development is a project management process focusing on
iterative work cycles, often called sprints. These cycles help
streamline the workflow and enhance team efficiency.
Agile is an excellent approach for teams aiming to rapidly
adapt to changes while maintaining a high level of customer satisfaction.

#Diff, as configured on a real page (2)

def calculate_area(radius):
    pi = 3.14
    area = pi * radius * radius
    print("The area is", area)
    return area
def calculate_area(radius):
    import math
    area = math.pi * radius ** 2
    return area

#Settings

Setting

Values

What it changes

Before

Any multi-line text

The original version. Renders in the left pane.

After

Any multi-line text

The changed version. Renders in the right pane, with differences from Before marked.



Small, and quietly useful.