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
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
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published Thursday in Confluence

Three common content challenges + how to manage them

An efficient enterprise content management system, or ECM, is a must-have for companies that create work online (cough   cough, all companies). If content calendars, marketing plans, and bu...

89 views 0 6
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