Details

Use :::details for optional or advanced content. It renders native <details> and <summary> markup.

1:::details[Advanced notes]{2  theme="glass"3  open="true"4}5These steps are only needed when running from source.6:::

Attributes

• [Label]: summary text, preferred for new Markdown
• title: summary text retained for existing Markdown
• open: use open="true" to render initially open
• theme: details theme name

Defaults:

• title="Details"
• theme="default"

Native Behavior

The directive uses browser-native disclosure behavior. It does not require client-side hydration.

Markdown Content

1:::details[Install from source]21. Clone the repository.32. Install dependencies.43. Run:5 6```bash7pnpm build8```9:::

Good Uses

• migration notes that only apply to older versions
• advanced configuration branches
• long generated examples
• caveats that should be available without interrupting a quick-start flow

Themes

Built-in details themes:

• default
• muted
• glass