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

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