skip to content
ΣathLab Journal
Table of Contents

可折叠 Admonitions

Astro Cactus 支持可折叠的 admonitions,让您可以隐藏长内容或次要信息。

语法

默认展开(可折叠)

:::note{fold=false}
这是默认展开的内容,用户可以点击折叠
:::

效果:

note

这是默认展开的内容,用户可以点击折叠

默认折叠(推荐)

:::warning{fold}
这是默认折叠的内容,用户需要点击查看
:::

效果:

warning

这是默认折叠的内容,用户需要点击查看

可以包含多段内容、代码块等。

也可以使用 fold=true

:::tip{fold=true}
fold=true 和 {fold} 效果相同,都是默认折叠
:::

效果:

tip

fold=true 和 {fold} 效果相同,都是默认折叠

所有支持的类型

所有 admonition 类型都支持折叠:

note

Note - 用于一般信息

tip

Tip - 用于提示和建议

important

Important - 用于重要信息

caution

Caution - 用于需要注意的事项

warning

Warning - 用于警告信息

语法总结

语法效果说明
{fold=false}默认展开可折叠
{fold=true}默认折叠需要点击展开
{fold}默认折叠最简洁
fold不可折叠普通 admonition

实际应用示例

note

什么时候使用可折叠?

可折叠的 admonitions 适合以下场景:

  1. 长内容 - 避免页面过长
  2. 可选信息 - 高级用户才需要的详细信息
  3. 示例代码 - 让读者自行选择查看
  4. 补充说明 - 非核心内容
tip

最佳实践

  • 默认折叠用于次要信息
  • 默认展开用于重要但可隐藏的内容
  • 普通(不折叠)用于关键信息