Summary

This feature request proposes enhancing the Expand Macro functionality by introducing flexible title formatting options. Authors should be able to select a specific heading level (H1–H6) or opt for list markup such as ordered list, unordered list, definition list, or plain text formatting for the macro title. This will provide greater control over content structure and improve accessibility for screen reader users.

Problem / Use Case

The current Expand Macro automatically applies a default heading tag to its title, which may not align with the author’s intent. This creates several issues:

• Semantic structure: It can disrupt the proper heading hierarchy.
• Accessibility: Screen readers rely on accurate heading usage.
• Lack of flexibility: Authors cannot control how the title is rendered.

These limitations make it difficult to create clean, accessible, and semantically correct content—especially in structured environments like documentation and knowledge bases.

Acceptance Criteria

Introduce a new Title Format dropdown in the Expand Macro configuration, offering the following options:

• Plain Text (no heading tag)
• Heading 1 (H1)
• Heading 2 (H2)
• Heading 3 (H3)
• Heading 4 (H4)
• Heading 5 (H5)
• Heading 6 (H6)
• Unordered List (ul, li)
• Ordered List (ol, li)
• Definition List (dl, dt, dd)

The selected format should be applied consistently in both the editor and the published content.

Additional Context

This enhancement will help authors create content that is accessible and compliant with WCAG Success Criterion 1.3.1: Info and Relationships.

Additionally, by allowing titles to use list markup or omit heading tags altogether, this feature provides the flexibility needed to tailor content presentation to specific use cases and preferences.