User Macro Language Reference

Kevin Rappold

I am new to Confluence macros but not to programming in general. So I know the types of things i want to do but can't find a very good reference style document on the language syntax of the user macro tool. The examples help but do not show all the variations, etc.

Bill Bailey

Yeah, getting started writing complex macros is a bit of a challenge, mainly because it is a mix of Velocity and Confluence Java Objects (not all of which are available in the Velocity context).

So I use this as a reference: http://velocity.apache.org/engine/1.7/.

And this forum is a huge help. There are a few articles like these (mine is listed first):

• Confluence-articles/Getting-Started-with-User-Macros-Writing-a-Wrapper-Macro/ba-p/979571
• A-User-Macro-to-Create-a-Table-From-an-Attached-CSV-File-Par (Davin has written a few)

They help in learning some of the tricks for performing more complex task. And then just lots and lots of Internet searches (and unfortunately, velocity gets a lot of non useful hits).

But yes, a dummy's guide to Confluence macros would be very useful. It took me quite some time to come up to speed.