极简 Wiki：04-短代码

极简(jijian) 主题内置多个实用的短代码，用于增强文章内容的表现力。本文档详细介绍各短代码的使用方法。

1️⃣ rawhtml

原始 HTML 短代码，用于在 Markdown 中插入原始 HTML 代码。

请不要插入h1,h2,h3,h4,h5,h6标签，否则会被识别到目录中去。

基本用法

1
2
3
4
5
{{< rawhtml >}}
<div style="color: red; font-size: 24px;">
    这是自定义 HTML 内容
</div>
{{< /rawhtml >}}

使用示例

自定义样式：

渐变背景

这是一段带渐变背景的文字

嵌入第三方组件（如网易云音乐播放器）：

自定义表格：

项目	状态
前端开发	✅ 完成

2️⃣ bilibili

用于在文章中嵌入哔哩哔哩视频。

完整参数

参数	类型	必需	说明
`bvid`	string	二选一	视频的 BV 号（推荐）
`aid`	string	二选一	视频的 AV 号
`cid`	string	否	视频 CID（多 P 视频时需要）
`page`	integer	否	多 P 视频的页码，默认为 1
`autoplay`	boolean	否	是否自动播放，默认 `false`

使用示例

基本用法：

1
{{< bilibili bvid="BV1111111111" >}}

多 P 视频（播放第 3 P）：

1
{{< bilibili bvid="BV1111111111" page="3" >}}

自动播放：

1
{{< bilibili bvid="BV1111111111" autoplay="true" >}}

3️⃣ figure

增强版图片展示短代码，支持标题、链接、对齐等功能。

完整参数

参数	类型	必需	说明
`src`	string	是	图片路径
`link`	string	否	点击图片跳转的链接
`target`	string	否	链接打开方式：`_blank`（新标签）、`_self`（当前标签）
`rel`	string	否	链接 rel 属性，如 `noopener`、`noreferrer`
`alt`	string	否	图片 alt 文本（若为空，默认使用说明文字）
`imgtitle`	string	否	鼠标悬停在图片上时显示的文字内容
`caption`	string	否	图片说明文字
`title`	string	否	图片下面的标题文字
`width`	string	否	图片宽度
`height`	string	否	图片高度
`class`	string	否	自定义 CSS 类名
`attr`	string	否	图片属性说明（如版权信息）
`attrlink`	string	否	属性说明的链接
`attrlink_target`	string	否	属性说明链接的打开方式：`_blank`、`_self`。如果不指定，外部链接 (`http` 或 `https`) 会自动在 `_blank` 中打开
`nozoom`	string	否	是否禁用放大：`true` 禁用

figure与灯箱功能的交互

如果设置了 link 参数，点击图片会跳转链接，不触发灯箱
如果未设置 link 参数，点击图片会触发 medium-zoom 灯箱效果

使用示例

带说明的图片：

外部链接图片：

4️⃣ collapse

可折叠的内容块，适合隐藏长篇内容或剧透内容。

完整参数

参数	类型	必需	说明
`summary`	string	是	折叠块标题（显示在折叠状态）
`openByDefault`	string	否	默认不展开，设为 `"true"` 展开

代码示例

折叠模式（默认）：

剧透警告

这里是剧透内容，默认隐藏。

展开模式

点击查看详细内容

这里是被折叠的内容，支持 Markdown 格式。

列表项 1
列表项 2

粗体文本 和 斜体文本 都可以正常显示。

5️⃣ vertical

中文古文竖排展示短代码，专门用于展示古诗词或特殊引用文段。

效果展示

下面是一段古文，使用 vertical 短代码后会变成从右往左的竖排版：

《水调歌头·明月几时有》 苏轼

丙辰中秋，欢饮达旦，大醉，作此篇，兼怀子由。

明月几时有，把酒问青天。

不知天上宫阙，今夕是何年。

我欲乘风归去，又恐琼楼玉宇，高处不胜寒。

起舞弄清影，何似在人间。

转朱阁，低绮户，照无眠。

不应有恨，何事长向别时圆？

人有悲欢离合，月有阴晴圆缺，此事古难全。

但愿人长久，千里共婵娟。

6️⃣ inTextImg

行内图片短代码，用于在文本中插入小图标或装饰性图片。

使用示例

1
这是我的一个图标：{{< inTextImg url="favicon-immmo-logo.svg" height="21" alt="immmo图标" >}} 继续显示文字。

这是我的一个图标：继续显示文字。

完整参数

参数	类型	必需	说明
`url`	string	是	图片路径
`height`	string	否	图片高度（像素），默认自动
`alt`	string	否	图片 alt 文本