How do I convert wiki markup inside the Wiki Markup Macro into the appropriate Confluence 4.0 Macros automatically?

[Ronald Horner]

We've upgraded to Confluence 4.0 and now we have lots of chunks of wiki markup contained in a Wiki Markup Macro on the WYSIWYG editor. The one that shows up the most often is the HTML Table Macro which is just the wiki markup but does work just fine as Confluence 4.0 Macros.

My question is how do I automatically transition these so as to not be old wiki markup wrapped in a macro?

[Joe Clark · Accepted solution]

Hey Ronald,

When you upgrade to Confluence 4.0, we have an upgrade task that runs on start-up that attempts to migrate all your content from wiki markup to XHTML (for use by the new editor).

Many Confluence plugins (including plugins included in the core Confluence installation) require upgrades themselves in order to be compatible with the new Confluence 4.0 editor & storage format.

In situations where the upgrade task encounters a page that contains content from macros that are not 4.0-compatible, the content will be wrapped in a "wiki markup macro" and left un-changed. This way, the page should still render/view correctly... you just won't get the full WYSIWYG editing experience.

After you have ugpraded any custom plugins to their latest, 4.0-compatible versions, you need to tell Confluence to re-run the content migration task, so that it can pick up the content that it previously skipped, and convert it to XHTML.

You can do this by selecting an option from the Confluence admin console - see the "Re-attempt Migration" section of this document: http://confluence.atlassian.com/display/DOC/Wiki+Markup+to+XHTML+Migration#WikiMarkuptoXHTMLMigration-Re-attemptMigration

[Ronald Horner]

Follow on question. How do I identify which macros are currently not version 4 compatible? My Confluence simply says that I have 457 pages that have macros that are not confluence 4 compatible.

[Joe Clark]

I don't think there is any way to get a definitive list. You can, however, head into the Confluence plugin admin console and then you should see on the "Upgrade" tab, a list of all plugins that have available upgrades from plugins.atlassian.com - this should cover all your bases in terms of macros that are not currently 4.0 compatible on your server, for which 4.0-compatible versions are available.