极简(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图标" >}} 继续显示文字。

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

完整参数

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