Rich Summaries

Summaries can include Markdown formatting when using headings or summary divs.

The summary attribute only supports plain text. To include formatting, use a heading or summary Div instead.

Using a Heading

The heading content preserves inline formatting:

::: {.details}
## Click for **important** `code` details

Content here.
:::

Gives:

Click for important code details

This summary has bold text and inline code formatting.

Using a Summary Div

For more complex summaries:

::: {.details}
::: {.summary}
**Warning:** This contains *advanced* configuration
:::

Advanced content here.
:::

Gives:

Warning: This contains advanced configuration

Here are the advanced configuration options:

  • Option A: For power users
  • Option B: Experimental feature
  • Option C: Use with caution

Conclusion

When using headings or a summary Div, e.g. # or ::: {.summary}, you can include rich formatting such as bold text, italics, code, lists, and more.