# 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.

![](https://help.gocapable.com/images/0b755735-323d-468d-8f8f-68e82a627470.webp)

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.](https://help.gocapable.com/images/7ff78655-d0fb-42fb-8627-14b16e0afb57.webp)

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. |

---

## Related

[MetadataDrops one piece of live page metadata — last updated, published date, version number, page titl](https://help.gocapable.com/macros/metadata.html)

[Color palettePublishes a named set of colours as a click-to-copy swatch bar or a Name / Colour / Code table.](https://help.gocapable.com/macros/color-palette.html)

[Page utilitiesThe rest of this family.](https://help.gocapable.com/macros/page-utilities.html)

---

_Small, and quietly useful._