极简(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 >}}

案例展示

自定义样式：

渐变背景

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

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

自定义表格：

指标 产品A 产品B 产品C 产品D
性能评分 92 88 95 91
能效评分 85 90 86 89

2️⃣ bilibili

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

使用示例

基本用法：

1

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

多 P 视频（播放第3P + 自动播放）：

1

{{< bilibili bvid="BV1111111111" page="3" autoplay="true" >}}

完整参数

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

3️⃣ figure

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

使用示例

1
2
3
4
5
6
7
8
9

{{< figure 
  src="极简演示图-2730x1535.webp"
  alt="这是图片描述"
  caption="这是图片说明"
  title="这是图片标题"
  imgtitle="鼠标悬停在图片上时显示的文字内容"
  attr="图片来源：网络"
  attrlink="https://ihcll.cn"
>}}

完整参数

参数 类型 必需 说明
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

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

使用示例

1
2
3

{{< collapse summary="剧透警告" openByDefault="true" >}}
这里是剧透内容，但默认状态以设为展开。
{{< /collapse >}}

完整参数

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

案例展示

折叠模式（默认）：

点击查看详细内容

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

  • 列表项 1
  • 列表项 2

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

展开模式

剧透警告 这里是剧透内容，不过现在已经展开了，你可以点击上面的“剧透警告”折叠起来。

5️⃣ vertical

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

使用示例

1
2
3

{{< vertical >}}
这里是竖排的内容。
{{< /vertical >}}

案例展示

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

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

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

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

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

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

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

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

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

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

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

6️⃣ inTextImg

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

示例和展示

1

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

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

完整参数

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

7️⃣ media

万能多媒体播放短代码，统一基于 xgplayer 构建。自动识别视频和音频；播放 HLS (.m3u8) 时会自动接入 xgplayer-hls 插件。

使用示例

播放本地 MP4 视频：

1

{{< media src="media/video.mp4" cover="media/cover.webp" >}}

播放 HLS 流媒体 (.m3u8)：

1

{{< media src="media/video_folder/index.m3u8" title="4K 婚礼剪辑" >}}

播放音频 (.mp3)：

1

{{< media src="media/music.mp3" title="浮光" >}}

完整参数

参数 类型 必需 说明
src string 是 媒体文件路径（相对于 static 目录）
cover string 否 封面图/海报图路径
title string 否 媒体标题（显示在播放器顶部或作为音频文件名）
type string 否 手动指定类型：video 或 audio（默认自动根据后缀识别）
autoplay boolean 否 是否自动播放，默认 false
muted boolean 否 是否静音，默认 false
loop boolean 否 是否循环播放，默认 false
hls boolean 否 是否强制启用 HLS 支持（若后缀不是 .m3u8 但仍是 HLS 流时使用）

8️⃣ pan

网盘下载卡片短代码，用于在文章末尾放出软件的网盘下载链接与提取码。以选项卡形式展示（多个网盘自动排成多个标签），会根据链接自动识别网盘类型并显示对应名称，找到图标后还会自动显示网盘图标。

使用示例

只有一个网盘时，直接给 pan 传 url 即可（渲染为一个标签的选项卡卡片）：

1
2

{{< pan url="https://lanzoui.com/xxxxx" />*/}}
{{</* pan name="某软件 v1.0" url="https://pan.baidu.com/s/1xxxx?pwd=a1b2" pwd="a1b2" note="永久有效" />*/}}

多个网盘时，在 pan 内用 pan-item 逐条列出（每个网盘一个标签）：

1
2
3
4
5

{{</* pan name="某软件 v1.0" >}}
{{< pan-item provider="baidu" url="https://pan.baidu.com/s/1xxxx" pwd="a1b2" note="永久有效" >}}
{{< pan-item provider="quark" url="https://pan.quark.cn/s/xxxx" pwd="c3d4" >}}
{{< pan-item url="https://www.123pan.com/s/xxxx" >}}
{{< /pan >}}

提示：单网盘的 pan 请写成自闭合 />}}，否则同一页出现多个 pan 时会因闭合标签配对出错；pan-item 直接写 >}} 即可，不要加自闭合斜杠。

完整参数

pan：

参数 类型 必需 说明
url string 是（或改用子项） 网盘链接。填写后直接作为唯一面板；留空则读取内嵌的 pan-item 子项
name string 否 软件/文件名
pwd string 否 提取码（别名 code），不填则不显示提取码区域
note string 否 备注文字（如"永久有效"）
provider string 否 手动指定网盘（key 取值见下表），覆盖自动识别

pan-item（放在 pan 内的子项，每一条对应一个标签）：

参数 类型 必需 说明
url string 是 网盘链接
pwd string 否 提取码（别名 code）
note string 否 备注文字
provider string 否 手动指定网盘（key 取值见下表），覆盖自动识别

自动识别与 provider 取值

不填 provider 时，会根据链接自动识别；填了则以 provider 为准。provider 的取值与网盘图标文件名一致：

provider 网盘
baidu 百度网盘
aliyun 阿里云盘
quark 夸克网盘
123pan 123云盘
lanzou 蓝奏云
tianyi 天翼云盘
115 115网盘
guangya 光鸭云盘
xunlei 迅雷云盘
mega MEGA
gdrive Google Drive
onedrive OneDrive
other 其他网盘

以下情况一律显示为"其他网盘"（配兜底云朵图标）：

  • 未填 provider 且链接解析不出来
  • provider="other"
  • 主动写 provider="微云"、provider="城通" 等未收录的网盘（也可直接写自定义文字作为显示名）

图标

主题内置了一个通用云朵图标兜底。将各网盘的 SVG（或 PNG）图标放入主题的 assets/img/pan/ 目录并按以下命名（如 baidu.svg、quark.svg），即可自动显示对应网盘的品牌图标，无需修改任何代码：

1
2

baidu.svg / aliyun.svg / quark.svg / 123pan.svg / lanzou.svg / tianyi.svg
115.svg / guangya.svg / xunlei.svg / mega.svg / gdrive.svg / onedrive.svg

案例展示

一个网盘：

某软件 v1.0

多个网盘：

某软件 v1.0