Upgrading Confluence Breaks the Display of Macro
After upgrading Confluence, inline macros surrounded by a heading have the paragraph (<p>) tag injected into them, which breaks the display of the macro. This is especially true when upgrading from Confluence 3.5.x to 4.x or later.
The migration task that converts wiki markup into the XHTML storage format is not context-aware enough to know when a macro is contained within a heading tag.
This is a workaround for Confluence 4.3.1
- Download the following patch: confluence-4.3.1.jar
To install the patch:
- Stop Confluence
- Rename CONF/confluence/WEB-INF/lib/confluence-4.3.1.jar to confluence-4.3.1.jar.backup
- Copy the attached confluence-4.3.1.jar to CONF/confluence/WEB-INF/lib/
- Start Confluence
- Launch the task to migrate incompatible macros, by navigating to <CONF_BASE_URL>/admin/unmigratedwikicontent.action)