Excerpt Macro
Screenshot: A project summary page containing a Children Display macro, configured to show the contents of the Excerpt macro on each child page.
Add this macro to your page
To add the Excerpt macro to a page:
- Unable to render {include} The included page could not be found.
- Choose Excerpt from the Confluence content category.
- Choose Insert.
Enter your text into the macro body. You can then publish your page to see the macro in action.
Screenshot: the Excerpt macro in the editor, containing a short project summary.
Using this macro
This macro must be used in conjunction with either the Excerpt Include, Children Display, or Blog Posts macros.
You can only have one excerpt per page. If you add more than one excerpt macro to a page, only the first one will be used by these macros.
You can choose to position the except on its own line, or inline with the surrounding text. This option affects only the page that contains the Excerpt macro, it doesn't affect how the content displays when it is reused on other pages.
Screenshot: The Excerpt macro placeholder and options panel
- New line
- Inline
Change the macro parameters
Here's a list of the parameters available in this macro.
Parameter | Default | Description |
---|---|---|
Hide Excerpted Content | false | Controls whether the page content contained in the Excerpt macro placeholder is displayed on the page. Note that this option affects only the page that contains the Excerpt macro. It does not affect any pages where the content is reused. |
Other ways to add this macro
Add this macro as you type
Add this macro using wiki markup
Macro name: excerpt
Macro body: Accepts rich text.
{excerpt:hidden=true|atlassian-macro-output-type=BLOCK}
This is the *text* I want to reuse in other pages. This text is inside an Excerpt macro.
{excerpt}