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

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?

1 answer

1 accepted

7 votes
Answer accepted
Joe Clark Atlassian Team Dec 08, 2011

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

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 Atlassian Team Dec 08, 2011

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.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

281 views 2 11
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you