Make use of macros in Confluence to expand the capabilities of your pages and then add labels to quickly organize your documentation.
In Confluence, you can add macros to a page to add extra functionality or include dynamic content. Macros are amazing! 🤯
Here are some macros which can help improve your documentation:
- Attachments macro to list files attached to a page
- Info Tip macro to visually distinguish text on the page that is meant to be a tip to users
- Expand macro to hide content and then reveal it when user's tap/click to learn more
- Code Block macro to enter neatly formatted code snippets
- Excerpt macro to add a short description to a page
- Excerpt Include macro to include the excerpt from another page
These show just some of the ways that macros can enhance your documentation. This list doesn't even go touch upon the macros that are available on Atlassian Marketplace. What's great about macros is that you can add extra functionality or dynamic content to your documentation without the need to code. This means you won't need to customize your content transformation processes to render content dynamically. As the writer, you have full creative control.
Learn more about using macros in Confluence.
Labels are key words you can add to your documentation pages to make them easier to group and find. As an example, you could assign the label administrator to all pages with content written for administrators. Then, you can browse all pages with that label, display a list of pages with that label using a macro, or search based on the label. Labels are great for working with documentation internally and for providing users a way to view and filter related pages.
Confluence lets you define the exact text of each label, so you can add any word that makes sense to help you to identify the content in your site.
Learn more about adding labels to pages in Confluence.
Add Images and Videos