682 字
3 分钟
提示容器
提示容器用于在文章中高亮特定级别的提示、警告、注意或可折叠区域,严格遵循 Material 3 Expressive 的容器表面分层设计。
语法格式
支持方括号标题与空格标题两种书写形式:
::: tip[操作提示]建议在修改核心配置前先运行类型检查。:::
::: warning 部署前检查若未配置正式域名,社交分享卡片可能无法正确生成。:::两种写法完全等价,方括号形式更适合标题中包含空格或标点的场景。
渲染效果:
全部容器类型
::: info 相关参考关于双仓架构的更多细节,请参阅内容分离指南。:::
::: caution 破坏性操作执行此命令将清除本地未提交的改动。:::
::: important 关键结论构建产物的体积直接决定首屏耗时。:::
::: note 普通笔记这一条只是补充记录,不构成操作建议。:::渲染效果:
折叠面板 details
details 容器渲染为原生的 <details> 折叠组件,适合放置日志、长清单与可选的补充说明:
::: details 点击展开详细日志构建过程的详细输出如下:
- 同步完成- 生成静态 HTML 成功:::渲染效果:
点击展开详细日志
构建过程的详细输出如下:
- 同步完成
- 生成静态 HTML 成功
支持的容器类型一览
| 类型 | 语义 | 视觉风格 |
|---|---|---|
tip | 技巧与建议 | 强调色彩容器与灯泡图标 |
info | 补充信息 | 主色调表面与信息图标 |
warning | 注意与预警 | 警示色调与三角感叹号 |
caution | 危险操作 | 错误色调与高对比警示框 |
important | 关键重点 | 鲜亮强调容器 |
note | 普通笔记 | 中性表面容器 |
details | 折叠面板 | 带箭头的原生 details 折叠组件 |
容器内部可以放什么
容器内部是完整的 Markdown 上下文,可以嵌套列表、代码块、表格乃至其它容器:
::: warning 依赖版本要求本地 Node.js 版本必须满足 `>= 22.12`:
```bashnode -v```:::渲染效果:
Markdown 语法
已完结分享文章
生成精美分享图或复制链接,与更多人分享本文。
继续阅读
换条路线
从其他文章中稳定抽取
最后更新于 ,距今已过 19 天
部分内容可能已过时
评论