用短代码排版及插入特殊功能

短代码是写在 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

青苔发布