用短代码排版及插入特殊功能
短代码是写在 markdown 里的特殊块,用 ::: 围栏语法创建标准 markdown 没有的布局与组件。青苔为每个短代码生成固定的类名,默认主题已经配好样式。
多栏网格
:::grid N 把内容排成 N 栏,单元格之间用 +++ 分隔。单元格里可以放任何 markdown——文字、图片、链接、卡片。
:::grid 2
左栏内容
右栏内容
+++
::::grid 2
左栏内容
+++
右栏内容
::::
:::
在栏数后加 `a:b` 比例可设置各栏宽度,如 `:::grid 2 1:2`。只把一个内部链接单独放进一格,青苔会把它渲染成带封面的卡片。
## 标注
用 `> [!类型]` 开头的引用块突出重要内容,类型有 `note`、`tip`、`warning`、`pending` 等。
:::grid 2 {.sc-demo}
```markdown
> [!note] 提示
> 这里是需要读者留意的内容。
+++
提示
这里是需要读者留意的内容。 :::
其他常用短代码
| 短代码 | 用途 |
|---|---|
::::buttons | 一排按钮,每个是一个链接 |
:::hero | 铺满宽度的大图,文字叠加其上 |
:::gallery | 图片画廊 |
::: {.类名} | 给一段内容附加 CSS 类,无需新短代码 |
最后一种「命名类围栏」最灵活:::: {.eyebrow} 之类给区块挂上类名,再在 主题的 style.css 里写样式即可,不必等待新的短代码。
深入了解
每个短代码的完整参数、单元格规则、卡片自动转换等,见英文文档 Shortcodes。