内置的外挂标签满足大部分用户的需求，不需要额外安装插件。
插件的外挂标签需要安装对应的插件，满足部分用户的特殊需求。

内置标签

Article

文章列表标签，用于显示文章列表。

1	{% article %}

参数	说明	默认值
path	文章路径	无

1	{% article 'p/96204d3d.html' %}

Chart

图表标签，用于显示图表。
打开配置文件中开关

1	chart: true

1	{% chart %}

不需要参数。

1 2	{% chart %} {% endchart %}

Gallery

图片列表标签，用于显示图片列表。

1 2	{% gallery %} {% endgallery %}

{% gallery %}

![](https://s3.qjqq.cn/47/674c6e226855e.png!water)
![](https://s3.qjqq.cn/47/674c6e226855e.png!water)
![](https://s3.qjqq.cn/47/674c6e226855e.png!water)
![](https://s3.qjqq.cn/47/674c6e226855e.png!water)
![](https://s3.qjqq.cn/47/674c6e226855e.png!water)

{% endgallery %}

GalleryGroup

图片组标签，用于显示图片组。

1	{% galleryGroup 'name' 'desc' 'url' 'img' %}

参数	说明	默认值
name	图片组名称	无
desc	图片组描述	无
url	图片组链接	无
img	图片组预览图	无

<div class='gallery-group-main'>
{% galleryGroup '旅行' '出行拍摄的杂七杂八' 'https://hsbc.com.cv' 'https://s3.qjqq.cn/47/674c6e226855e.png!color' %}
{% galleryGroup '旅行' '出行拍摄的杂七杂八' 'https://hsbc.com.cv' 'https://s3.qjqq.cn/47/674c6e5d63fda.png!color' %}
</div>

Mermaid

Mermaid 标签，用于显示 Mermaid 图表。

1	mermaid: true

1
2
3

{% mermaid %}
content
{% endmermaid %}

{% mermaid %}
pie
title Key elements in Product X
"Calcium" : 42.96
"Potassium" : 50.05
"Magnesium" : 10.01
"Iron" : 5
{% endmermaid %}

Typeit

Typeit 标签，用于显示 Typeit 动画。

1	typeit: true

1
2
3

{% typeit 'div' %}
options
{% endtypeit %}

参数	说明	默认值
div	标签名	无

{% typeit 'div' }
waitUntilVisible: true,
strings: "Alex MacArthur",
{% endtypeit %}

Tabs

标签页标签，用于显示标签页。

{% tabs 唯一名称, [index] %}

<!-- tab [唯一Tab] [@icon] -->

任何内容（也支持内联标签）。

<!-- endtab -->

{% endtabs %}

{% tabs test1 %}

<!-- tab -->

**This is Tab 1.**

<!-- endtab -->

<!-- tab -->

**This is Tab 2.**

<!-- endtab -->

<!-- tab -->

**This is Tab 3.**

<!-- endtab -->

{% endtabs %}

基础

This is Tab 1.

This is Tab 2.

This is Tab 3.

预选择tab

This is Tab 1.

This is Tab 2.

This is Tab 3.

插件标签

安装插件

1	npm i hexo-solitude-tag

Youtube

Youtube 标签，用于显示 Youtube 视频。

1	{% youtube video_id [type] [cookie] %}

参数	说明	默认值
video_id	视频 ID	无
type	视频类型	video
cookie	是否使用 cookie	false

1	{% youtube 'P2BTRcX0AV0' %}

Bilibili

Bilibili 标签，用于显示 Bilibili 视频。

1	{% bvideo video_id %}

参数	说明	默认值
video_id	视频 ID	无

1	{% bvideo 'BV1jb4y1j7eM' %}

Audio

Audio 标签，用于显示音频。

1	{% audio url %}

参数	说明	默认值
url	音频链接	无

1	{% audio 'https://music.163.com/song/media/outer/url?id=1973678968.mp3' %}

Video

Video 标签，用于显示视频。

1	{% video url %}

参数	说明	默认值
url	视频链接	无

1	{% video 'https://media.w3.org/2010/05/sintel/trailer.mp4' %}

Videos

Videos 标签，用于显示视频列表。

1 2	{% videos [col] %} {% endvideos %}

参数	说明	默认值
col	列数	1

{% videos 2 %}
{% video 'https://media.w3.org/2010/05/sintel/trailer.mp4' %}
{% video 'https://media.w3.org/2010/05/bunny/trailer.mp4' %}
{% endvideos %}

P

没错，就是 P 标签。

1	{% p [cls] [content] %}

参数	说明	默认值
cls	类名	无
content	内容	无

cls: center, left, right, h1, h2, h3, h4, h5, h6, red, green, blue, yellow, purple, orange, gray

1	{% p 'center h2' 'Hello World!' %}

Hello World!

Span

没错，就是 Span 标签。

1	{% span [cls] [content] %}

参数	说明	默认值
cls	类名	无
content	内容	无

1	{% span 'red h2' 'Hello World!' %}

Hello World!

Fold

折叠标签，用于显示折叠内容。

1
2
3

{% fold 'title' open %}
content
{% endfold %}

参数	说明	默认值
title	标题	无
open	是否展开	不填不显示

1
2
3

{% fold 'title' open %}
content
{% endfold %}

title

content

Img

图片标签，用于显示图片。

1	{% img url [alt] [style] %}

参数	说明	默认值
url	图片链接	无
alt	图片描述	无
style	图片样式	无

1	{% img 'https://hsbc.com.cv/pic/avatar.jpeg/cover' 'cover' 'width: 200px' %}

Inline Img

内联图片标签，用于显示内联图片。

1	{% inline_img url [alt] [style] %}

参数	说明	默认值
url	图片链接	无
alt	图片描述	无
style	图片样式	无

1	{% inline_img 'https://hsbc.com.cv/pic/avatar.jpeg/cover' 'cover' '20px' %}

Note

Note 标签，用于显示提示。

1
2
3

{% note 'type' 'icon' %}
content
{% endnote %}

参数	说明	默认值
type	类型	无
icon	图标	无

type: primary, success, warning, danger, info, modern, flat, simple
icon: fantawesome 图标（例如： fas fa-mail）

1
2
3

{% note 'danger modern' 'fas fa-wand-magic-sparkles' %}
content
{% endnote %}

content

Card

Card 标签，用于显示卡片。

1	{% card 'title','url','cover','score','desc','icon','tag','width','height' %}

参数	说明	默认值
title	标题	无
url	链接	无
cover	封面	无
score	评分	无
desc	评价	无
icon	图标	无
tag	标签	无
width	宽度	无
height	高度	无

{% card '诡秘之主','https://book.qidian.com/info/1010868264/','https://bookcover.yuewen.com/qdbimg/349573/1010868264/300','4.5','第一次接触这种西方文学小说，刚开始感觉看不懂，断断续续看了很多次。后来越看越觉好看，每次看甚至都需要查“文档”','fa-solid fa-book-open','小说' %}

第一次接触这种西方文学小说，刚开始感觉看不懂，断断续续看了很多次。后来越看越觉好看，每次看甚至都需要查“文档”查看详情

小说

诡秘之主

Link

用于展示链接

1	{% link 'titke' 'subtitke' 'url' %}

参数	说明	默认值
title	标题	无
subtitke	副标题	无
url	链接	无

1	{% link 'Solitude' '一款简洁优雅并易用的 Hexo 博客主题' 'https://solitude.js.org/zh' %}

引用站外链接

Solitude

一款简洁优雅并易用的 Hexo 博客主题

Checkbox

展示复选框

1	{% checkbox 'style' 'checked' 'content' %}

参数	说明	默认值
style	样式	无
checked	是否选中	checked
content	内容	无

1 2	{% checkbox 'times red' checked '选中' %} {% checkbox 'plus blue' 'checked' '未选中' %}

选中

未选中

Button

展示按钮

1	{% button 'icon' 'content' 'url' %}

参数	说明	默认值
icon	图标	无
content	内容	无
url	链接	无

1	{% button 'fas fa-wand-magic-sparkles' '按钮' 'https://hsbc.com.cv/zh' %}

Github Repo

展示 Github 仓库

1	{% github 'repo' %}

参数	说明	默认值
repo	仓库	无

1	{% github 'dstansice/hexo-theme-solitude' %}

Gitea Repo

展示 Gitea 仓库

1	{% gitea 'server' 'repo' %}

参数	说明	默认值
server	服务器	无
repo	仓库	无

1	{% gitea 'https://git.fsfe.org' 'FSFE/fsfe-website' %}

Gitee Repo

展示 Gitee 仓库

1	{% gitee 'repo' %}

参数	说明	默认值
repo	仓库	无

1	{% gitee 'skycf/small-rocket-lua-file-backup' %}

Gitlab Repo

展示 Gitlab 仓库

1	{% gitlab 'id' %}

参数	说明	默认值
id	仓库 ID	无

1	{% gitlab 'gitlab-org/gitlab' %}

Bubble

展示气泡

1	{% bubble 'content' 'notation' 'color' %}

参数	说明	默认值
content	内容	无
notation	符号	无
color	颜色	无

1	{% bubble '我是一段文字内容，这是我写的东西' '我是提示文字' 'red' %}

我是一段文字内容，这是我写的东西我是提示文字

Keyboard

展示键盘按键

1	{% keyboard 'key' %}

参数	说明	默认值
key	按键	无

1	{% keyboard 'ctrl' %}

Ctrl

Spoiler

展示剧透

1	{% spoiler 'style' 'content' %}

参数	说明	默认值
style	样式	blur / block
content	内容	无

1 2	{% spoiler 'block' '我是一段文字内容，这是我写的东西' %} {% spoiler 'blur' '我是一段文字内容，这是我写的东西' %}

我是一段文字内容，这是我写的东西
我是一段文字内容，这是我写的东西