Swiftorial Logo
Home
Swift Lessons
Tutorials
Learn More
Career
Resources

Using Macros in Confluence

Introduction to Macros

Macros in Confluence are powerful tools that allow users to enhance their pages with dynamic content and functionalities. They can be used to display various types of information, integrate with other applications, and create interactive elements on your Confluence pages.

Types of Macros

There are several types of macros available in Confluence, including:

  • Formatting Macros: Change the appearance of text, like headings and panels.
  • Content Macros: Display dynamic content, such as the Page Tree or Blog Posts.
  • Multimedia Macros: Embed videos, images, and other media.
  • Integration Macros: Connect with external applications, such as JIRA or Trello.

How to Insert a Macro

To insert a macro in Confluence, follow these steps:

  1. Open the page where you want to add a macro.
  2. Click the "+" icon in the editor toolbar.
  3. Select "Other Macros" from the dropdown menu.
  4. In the macro browser, search for the macro you want to use.
  5. Select the macro and configure its settings as needed.
  6. Click "Insert" to add the macro to your page.

Example: Inserting a "Task List" Macro.

1. Click "+" > "Other Macros" > Search "Task List" > Select > Insert

Commonly Used Macros

Here are some commonly used macros in Confluence:

  • Page Include: Displays the content of another page.
  • Expand: Allows you to hide or reveal content.
  • Table of Contents: Automatically generates a table of contents based on headings in the page.
  • Code Block: Displays formatted code snippets.

Example: Using the Code Block Macro

The Code Block macro is particularly useful for sharing code snippets or configuration files. Here’s how to use it:

  1. Follow the steps to insert a macro (as explained above).
  2. Search for "Code Block" in the macro browser.
  3. Select it and specify the programming language for syntax highlighting.
  4. Insert your code into the provided field.
  5. Click "Insert" to add the macro to your page.

Example Code:

function helloWorld() {
  console.log("Hello, World!");
}

Conclusion

Macros are a powerful way to enhance your Confluence pages, making them more interactive and informative. By incorporating various macros, you can streamline your documentation, present information in a more engaging manner, and improve collaboration within your team.

Experiment with different macros to see how they can best serve your needs and help you create richer content in Confluence.