Using Macros
With macros, you can add dynamic content and extra functionality to your help center pages.
Learn more about macros.
Macros Integrated into the Help Center theme
There are a number of macros that are not rendered similar to how they look or work in Confluence, but are integrated into the theme either by being embedded into the navigation or changing the visual output to match the style.
Code: The code macro renders with source code highlighting and a one-click copy button. Source code highlighting supports HTML and XML and since Scroll Viewport 2.18.3 also supports Bash, C, C++, C#, git, ASP.NET, Java, Json, Perl, PHP, Python, Ruby, SQL, Velocity, YAML. To use source code highlighting the language must be set in the code macro.
Display children: This macro renders like an accordion menu with each entry representing a child page. Set children depth to 2 to make the accordion expand.
Excerpt: Content within the excerpt macro is used as a page description in the Help Center theme whenever the page is represented as a tile.
Content by label: A list of the labelled pages appears in the right sidebar, below the ToC. This macro is particularly useful to list related articles.
Table of contents: This macro is omitted in the Help Center theme, as an interactive ToC is part of every article page.
Macro Errors
To optimize your user's help experience, if a macro is retuning an error, nothing is displayed to users who aren't logged in. For Confluence users who are logged in, the error displays along with a link to switch back to Confluence so they can fix the issue.
Not Supported Macros
These are the macros that are not compatible with the Help Center theme:
Because there are so many macros available, the Help Center theme supports the most common use cases. To request support for another macro, please contact us at help@k15t.com.