How to Add a Collapsible Section in Confluence?

[Ramesh Maduranga]

Hello,  I’m looking to add collapsible sections to my Confluence pages. I tried using the following tags in a Markdown file:

<details> <summary>Click here to expand…</summary> </details>

However, this doesn’t seem to work once I push the Markdown file to Confluence. It displays as plain text instead of creating a collapsible section.

Is there a recommended way to create collapsible sections in Confluence, or any workaround for achieving this functionality? Any advice would be greatly appreciated!

Note: I'm trying to achieve this by updating a .md file and pushing it to Confluence using a Python script.

[Evgenii]

Hi, @Ramesh Maduranga 

Welcome to Atlassian Community!

You can use expand macro for this.

[Ramesh Maduranga]

@Evgenii Thanks for the suggestion.  Just wondering is there any way to achieve this directly in Markdown by embedding the expand macro?

[Evgenii]

Hi, @Ramesh Maduranga 

If in a few words, then the answer to your question is: no.

According to Atlassian Markdown syntax guide documentation, you can use only limited Markdown for formatting text.

In the doc above you can find the syntax you can use in your markdown.

[Ramesh Maduranga]

@Evgenii Thank you! This would be a fantastic feature to have, and I’d love to see it considered.

[mhirsch]

Just to add a use case to @Ramesh Maduranga, I'm using an LLM (not Atlassian Intelligence) to auto-generate Confluence pages. I'd like to have the LLM generate text I can just paste into a blank Confluence page, including the expand macro around some content. I don't want to use the REST API because that adds too much complexity as I share my LLM workflow with colleagues.