Skip to Content

Excerpt Macro

Version 7.1 by Yana Oksner on 2025/07/18 12:19
Warning
For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Description

The Excerpt macro is a bridge between Confluence and XWiki. It allows the user to mark part of the page's content for use by other macros, for exemple {excerpt-include}}.

Parameters

ParameterDescriptionDefault
atlassian-macro-output-typeThe ouput type. It can be either BLOCK or INLINE.INLINE
hiddenIf true, the content of the macro will be hidden.false
nameThe name of the excerpt, for named includes.false
allowUnprivilegedIncludeAllow this excerpt to be seen even for people who don't have view rights on this page when includedfalse

Example of usage

Example of excerpt with a table in it:

{{excerpt}}
|=Title1|=Title2|=Title3
|Text1|Text2|Text3
{{/excerpt}}

The result is the following:

Error

There is no valid license for Pro Macros. Please visit the Licenses section.

Example of named hidden excerpt:

{{excerpt hidden="true" name="myexcerpt"}}
My hidden content.
{{/excerpt}}

The result is the following:

Error

There is no valid license for Pro Macros. Please visit the Licenses section.

(yes, nothing, this is intended!)

Let's include this hidden excerpt:

{{excerpt-include 0="Excerpt" name="myexcerpt"/}}

Result:

Unknown macro: excerpt-include. Click on this message for details.

Without the panel:

{{excerpt-include 0="Excerpt" name="myexcerpt" nopanel="true"/}}

Result:

Unknown macro: excerpt-include. Click on this message for details.