These tutorials explain how to implement XWiki Macros using XWiki's Rendering Architecture.

Implementation Options

XWiki Rendering macros can be written either in Java or directly in wiki pages:

• XWiki Rendering Macro in Java Tutorial
• XWiki Rendering Macro in Wiki page Tutorial

Comparison

If you're wondering whether to write your Rendering Macro in Java or in a wiki page, the following table provides some comparison between both options.

Characteristics	Java Macro	Wiki Macro
Easy to debug
Easy to write an automated test for
Optimized for performance
Advanced parameter metadata support (advanced, deprecated, grouping)
Doesn't require development skills
Easy for a user to customize
Fast to write and manually test