Symptoms

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.

Cause

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.  

Workaround

• Download the following patch: confluence-4.3.1.jar

To install the patch:

1. Stop Confluence
2. Rename CONF/confluence/WEB-INF/lib/confluence-4.3.1.jar to confluence-4.3.1.jar.backup
3. Copy the attached confluence-4.3.1.jar to CONF/confluence/WEB-INF/lib/
4. Start Confluence
5. Launch the task to migrate incompatible macros, by navigating to <CONF_BASE_URL>/admin/unmigratedwikicontent.action)