Consider using an excerpt or multiexcerpt in the following cases:
- Displaying excerpts in a Page Tree or Children Display macro. For information, refer to Putting a List of Child Pages on a Page.
- Displaying excerpts from blog or news posts. For information, refer to Attracting Attention to the Blog (News) Posts.
- Displaying a multiexcerpt to mark a link as external. For information, refer to Marking Links as External to US Government.
If you want two wiki pages to display the same content, consider using an Include page, rather than using an excerpt or multiexcerpt, because it is easier to keep track of Include pages. You can look at the Page Information page for an Include page to see where it is used, but it is very difficult to determine where an excerpt or multi-excerpt is used. For information, refer to Including the Content of a Page on Another Page.
This page and the following child pages demonstrate including an excerpt from one page on another page.
Open the child pages and on the Tools menu select View Source to see the Confluence editor view of the macros used.
Example of including an excerpt
The following is an example of the Excerpt include macro. The excerpt is in italics.
This is an Excerpt on a page titled "Page with Excerpt." Excerpts are useful, but each page can have only one. The Multiexcerpt macro allows for creating as many excerpts as needed on a single page.
For instructions, refer to the following Atlassian help pages:
- https://confluence.atlassian.com/conf613/excerpt-macro-964960810.html
- https://confluence.atlassian.com/conf613/excerpt-include-macro-964960809.html
Example of including multiple excerpts
The following is an example of a Multiexcerpt include macro. The multiexcerpt is in italics.
This is a multiexcerpt on the page titled "Page with Multiexcerpts" and having the name MultiExcerptExampleOne. Use the Multiexcerpt macro to create more than one excerpt on any page.
The following is another example of a Multiexcerpt include macro, for a multiexcerpt on the same page. The multiexcerpt is in italics.
This is a multiexcerpt on the page titled "Page with Multiexcerpts" and having the name MultiExcerptExampleTwo. This shows more than one excerpt on a single page for including on another page.
You can define as many excerpts as needed on a single page with the Multiexcerpt macro. You can include a Multiexcerpt from a page in another space. The page title is in the form "spacekey:pageName."
If you include Multiexcerpts inside one another (nest them) bulleted lists will not be rendered properly. Links in a Multiexcerpt include may not be rendered properly in another Multiexcerpt include.
For instructions, refer to the following Atlassian help page:
