Markdown与外挂标签

Markdown基础语法

注意：此页面偶尔会存在CSS冲突问题!

代码块

注意： 代码块中的所有内容都会被认为是代码，不可以嵌套其他Markdown语法。
可以添加行内代码块，比如方法名称之类的

• 样例预览
• 标签用法

我是行内代码

我是行内`代码`

多级标题

在Markdown中多级标题最多只有六级

# H1
## H2
### H3
#### H4
##### H5
###### H6

文字样式

• 样例预览
• 标签用法

文字加粗展示：加粗
文字斜体演示斜体
文字高亮演示：高亮
文本删除线演示删除
如果想同时使用加粗和斜体：加粗和斜体

文字加粗展示： **加粗**
文字斜体演示： *斜体*
文字高亮演示： `高亮`
文本删除线演示：~~删除~~
如果想同时使用加粗和斜体：***加粗和斜体***

想单纯使用这些特殊的符号时，可以使用转义符

• 样例预览
• 标签用法

我是转义的*符号

我是转义的\*符号

下划线和分割线

在Markdown原生语法中没有提供对应的符号，只能借助HTML代码来实现，Markdown支持在文本中嵌入HTML标签，包括其样式

• 样例预览
• 标签用法

我是要添加下划线的内容

<u> 我是要添加下划线的内容 </u>

想使用分割线只需要在单独的一行连续使用三个及以上的*即可：

列表和勾选框

列表分为有序列表和无序列表
要创建一个无序列表，只需要使用*作为前缀，空一格再输入内容即可：

• 样例预览
• 标签用法

• 无序列表1
• 无序列表2
• 无序列表3

* 无序列表1
* 无序列表2
* 无序列表3 

创建一个有序列表，使用数字+小数点+空格的形式即可：

• 样例预览
• 标签用法

1. 有序列表1
2. 有序列表2
3. 有序列表3

1. 有序列表1
2. 有序列表2
3. 有序列表3

在列表中换行他会识别为换行编写，如果想脱离列表，需要连续两个换行
列表支持多个层级嵌套，我们可以在一级列表下创建二级列表，要表示二级列表，我们可以在前面添加两个或四个空格（也可以是一个TAB缩进），表示此列表是上一个列表的子级：

• 样例预览
• 标签用法

• 无序列表1
  • 二级列表1
• 无序列表2
  • 二级列表2

* 无序列表1
    * 二级列表1
* 无序列表2
    * 二级列表2

如果我们想创建一个勾选框，只需要在无序列表后面加入一个方括号即可：

• 样例预览
• 标签用法

• [ ] 无序列表1
• [ ] 无序列表2

* [ ] 无序列表1
* [ ] 无序列表2

如果要创建一个已勾选的勾选框，只需要在方括号中加入一个x即可：

• 样例预览
• 标签用法

• [x] 无序列表1
• [x] 无序列表2

* [x] 无序列表1
* [x] 无序列表2

引用

在最前面添加>大于符号即可表示后面的文本为引用文本，注意空格：

• 样例预览
• 标签用法

引用内容

> 使用引用

直接在引用块内换行，会被认为是在引用块内换行,只有两个连续的换行才能脱离引用块

引用块内可以嵌套其他Markdwown内容，比如列表或代码块，甚至引用里嵌套引用

• 样例预览
• 样例代码

引用内容

引用内容

引用内容

> 引用内容
>> 引用内容
>>> 引用内容

链接和图片

使用[]和()组合就能在Markdown文档中插入超链接

• 样例预览
• 标签用法

首页

[链接文本](链接地址)

插入图片与插入链接类似，语法格式为：

• 样例预览

其实就是链接的写法前面多加了一个感叹号。Markdown文档是纯文本格式，无法像Word那样真的放一张图片进去，因此我们只能使用本地图片地址或是网络图片地址。

上标和下标

在Markdown中，我们可以通过HTML标签来实现上标和下标

• 样例预览
• 标签用法

a₂
a²

a<sub>2</sub>
a<sup>2</sup>

脚注

在Markdown中也可以像这样编写脚注（部分编辑器不支持），鼠标移动上去会展示脚注内容

• 样例预览
• 样例代码

老师我想学PHP¹

老师我想学PHP[^1]
[^1]:世界上最好的语言

表格

在Markdown中创建表格有一点点复杂，创建时最上面一排是表头，在左右使用|表示这是一个表格，同时，下方需要添加分割线，分割线使用-减号表示，写一个或多个都可以

• 样例预览
• 样例代码

名称	年龄	性别
张三	18	男
李四	20	女
王五	22	男

|名称|年龄|性别|
| :----: | :------: | :--: |
|张三|18 |男|
|李四|20 |女|
|王五|22 |男|

Markdown支持对齐调整只需要使用:调整分割线

:--- 为左对齐
---: 为右对齐
:---: 为居中对齐

表格中可以嵌套其他Markdown语法

HTML标签

可以通过html标签增加markdown的个性化，如修改文字颜色，自定义图片大小

• 样例预览
• 标签用法

我是红色的文本

我是<span style="color: red">红色</span>的文本

扩展语法

以下扩展语法部分编辑器不支持，Typora需要在设置中开启

文本高亮

• 样例预览
• 标签用法

==文本高亮==

==文本高亮==

上下标

• 样例预览
• 标签用法

文本^我是上标^
文本~我是下标~

文本^我是上标^
文本~我是下标~

数学公式

数学公式个人使用较少，简单记录
Typora需要开启内联公式支持

编写数学公式需要在特定的块中编写，公式块用$表示，多行公式使用连续的两个美元符：

$$
公式
$$

在行内编写，只需要在显示的地方使用一个$即可

公式为：$x=2y$

特殊数学符号

一些无法直接通过键盘输入的特殊符号

代码	符号	描述
\not=	≠\=	不等于
\approx	≈≈	约等于
\times	××	乘号
\div	÷÷	除号
\leq	≤≤	小于等于
\geq	≥≥	大于等于
\pm	±±	正负号
\sum	∑∑	求和符号（累加）
\prod	∏∏	累乘
\coprod	∐∐	累除
\overline{a + b + c}	a+b+c‾a+b+c	平均值

数学中常见特殊字符：

代码	符号	代码	符号
\alpha	αα	\beta	ββ
\gamma	γγ	\delta	δδ
\epsilon	ϵϵ	\eta	ηη
\theta	θθ	\pi	ππ
\omega	ωω	\rho	ρρ
\sigma	σσ	\mu	μμ

还有三角函数相关：

代码	符号	描述
\sin	sin⁡sin	正弦
\cos	cos⁡cos	余弦
\tan	tan⁡tan	正切
\cot	cot⁡cot	余切
\sec	sec⁡sec	正割
\csc	csc⁡csc	余割
\circ	∘∘	度

积分和求导相关：

代码	符号	描述
\infty	∞∞	无穷
\int	∫∫	定积分
\iint	∬∬	双重积分
\iiint	∭∭	三重积分
\oint	∮∮	曲线积分
x\prime	x′x′	求导
\lim	lim⁡lim	极限

集合相关：

代码	符号	描述
\emptyset	∅∅	空集
\in	∈∈	属于
\notin	∉∈/	不属于
\supset	⊃⊃	真包含
\supseteq	⊇⊇	包含
\bigcap	⋂⋂	交集
\bigcup	⋃⋃	并集

对数函数相关：

代码	符号	描述
\log	log⁡log	对数函数
\ln	ln⁡ln	以e为底的对数函数
\lg	lg⁡lg	以10为底的对数函数

分数

分数使用\farc来表示：

$ \frac{分子}{分母} $

开方

开方使用\sqrt来表示，具体格式如下：

markdown复制代码

$\sqrt{4}$

如果需要修改根号上方数值，可以添加中括号：

$\sqrt[3]{8}$ //意思是8开三次方根

上下标

在公式块中的上下标与Markdown中的不同，语法也不一样，其中^表示上标， _表示下标：

markdown复制代码

$ x_下标 $
$ x^上标 $
$ x^上标_下标 $

如果上标或下标内容多于一个字符，需要使用 {} 括起来，包括后续的其他代码如果出现只有一个字符生效的情况下，考虑使用花括号囊括全部内容：

markdown复制代码

$ x_{下标} $
$ x^{上标} $
$ x^{上标}_{下标} $

积分和极限

积分非常简单，直接使用上下标即可指定范围，后续的内容可以直接向后编写，会自动居中摆放：

$ \int_1^2xdx $

极限与积分类似，同样使用下标即可：

$ \lim_{n\rightarrow+\infty}\frac{1}{n + 1} $

其他符号

向量符号：

$ \vec{a} $

省略号：

$ \cdots $   居中省略号
$ \ldots $   靠底部的省略号

点乘号：

$ \cdot $

累加：

$ \sum_1^n $

外挂标签

引用 note

• 样式展示
• 语法格式
• 配置参数
• 示例源码

方法一

1. simple样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

1. modern样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

3. flat样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

1. disabled

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

1. no-icon样式

默认 提示块标签

default 提示块标签

primary 提示块标签

success 提示块标签

info 提示块标签

warning 提示块标签

danger 提示块标签

方法二

1. simple样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

1. modern样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

1. flat样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

1. disabled

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

1. no-icon样式

你是刷 Visa 还是 UnionPay

2021年快到了….

小心开车 安全至上

这是三片呢？还是四片？

你是刷 Visa 还是 UnionPay

剪刀石头布

前端最讨厌的浏览器

方法一

{% note [class] [no-icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}

方法二

{% note [color] [icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}

方法一

参数	用法
class	【可选】标识，不同的标识有不同的配色 （ default / primary / success / info / warning / danger ）
no-icon	【可选】不显示 icon
style	【可选】可以覆盖配置中的 style （simple/modern/flat/disabled）

方法二

参数	用法
class	【可选】标识，不同的标识有不同的配色 （ default / blue / pink / red / purple / orange / green ）
no-icon	【可选】可配置自定义 icon (只支持 fontawesome 图标, 也可以配置 no-icon )
style	【可选】可以覆盖配置中的 style （simple/modern/flat/disabled）

方法一

1. simple样式

   {% note simple %}默认 提示块标签{% endnote %}
   
   {% note default simple %}default 提示块标签{% endnote %}
   
   {% note primary simple %}primary 提示块标签{% endnote %}
   
   {% note success simple %}success 提示块标签{% endnote %}
   
   {% note info simple %}info 提示块标签{% endnote %}
   
   {% note warning simple %}warning 提示块标签{% endnote %}
   
   {% note danger simple %}danger 提示块标签{% endnote %}

2. modern样式

   {% note modern %}默认 提示块标签{% endnote %}
   
   {% note default modern %}default 提示块标签{% endnote %}
   
   {% note primary modern %}primary 提示块标签{% endnote %}
   
   {% note success modern %}success 提示块标签{% endnote %}
   
   {% note info modern %}info 提示块标签{% endnote %}
   
   {% note warning modern %}warning 提示块标签{% endnote %}
   
   {% note danger modern %}danger 提示块标签{% endnote %}

3. flat样式

   {% note flat %}默认 提示块标签{% endnote %}
   
   {% note default flat %}default 提示块标签{% endnote %}
   
   {% note primary flat %}primary 提示块标签{% endnote %}
   
   {% note success flat %}success 提示块标签{% endnote %}
   
   {% note info flat %}info 提示块标签{% endnote %}
   
   {% note warning flat %}warning 提示块标签{% endnote %}
   
   {% note danger flat %}danger 提示块标签{% endnote %}

4. disabled

   {% note disabled %}默认 提示块标签{% endnote %}
   
   {% note default disabled %}default 提示块标签{% endnote %}
   
   {% note primary disabled %}primary 提示块标签{% endnote %}
   
   {% note success disabled %}success 提示块标签{% endnote %}
   
   {% note info disabled %}info 提示块标签{% endnote %}
   
   {% note warning disabled %}warning 提示块标签{% endnote %}
   
   {% note danger disabled %}danger 提示块标签{% endnote %}

5. no-icon样式

   {% note no-icon %}默认 提示块标签{% endnote %}
   
   {% note default no-icon %}default 提示块标签{% endnote %}
   
   {% note primary no-icon %}primary 提示块标签{% endnote %}
   
   {% note success no-icon %}success 提示块标签{% endnote %}
   
   {% note info no-icon %}info 提示块标签{% endnote %}
   
   {% note warning no-icon %}warning 提示块标签{% endnote %}
   
   {% note danger no-icon %}danger 提示块标签{% endnote %}

方法二

1. simple样式

   {% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note blue 'fas fa-bullhorn' simple %}2021年快到了....{% endnote %}
   
   {% note pink 'fas fa-car-crash' simple %}小心开车 安全至上{% endnote %}
   
   {% note red 'fas fa-fan' simple%}这是三片呢？还是四片？{% endnote %}
   
   {% note orange 'fas fa-battery-half' simple %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note purple 'far fa-hand-scissors' simple %}剪刀石头布{% endnote %}
   
   {% note green 'fab fa-internet-explorer' simple %}前端最讨厌的浏览器{% endnote %}

2. modern样式

   {% note 'fab fa-cc-visa' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note blue 'fas fa-bullhorn' modern %}2021年快到了....{% endnote %}
   
   {% note pink 'fas fa-car-crash' modern %}小心开车 安全至上{% endnote %}
   
   {% note red 'fas fa-fan' modern%}这是三片呢？还是四片？{% endnote %}
   
   {% note orange 'fas fa-battery-half' modern %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note purple 'far fa-hand-scissors' modern %}剪刀石头布{% endnote %}
   
   {% note green 'fab fa-internet-explorer' modern %}前端最讨厌的浏览器{% endnote %}

3. flat样式

   {% note 'fab fa-cc-visa' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note blue 'fas fa-bullhorn' flat %}2021年快到了....{% endnote %}
   
   {% note pink 'fas fa-car-crash' flat %}小心开车 安全至上{% endnote %}
   
   {% note red 'fas fa-fan' flat%}这是三片呢？还是四片？{% endnote %}
   
   {% note orange 'fas fa-battery-half' flat %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note purple 'far fa-hand-scissors' flat %}剪刀石头布{% endnote %}
   
   {% note green 'fab fa-internet-explorer' flat %}前端最讨厌的浏览器{% endnote %}

4. disabled

   {% note 'fab fa-cc-visa' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note blue 'fas fa-bullhorn' disabled %}2021年快到了....{% endnote %}
   
   {% note pink 'fas fa-car-crash' disabled %}小心开车 安全至上{% endnote %}
   
   {% note red 'fas fa-fan' disabled %}这是三片呢？还是四片？{% endnote %}
   
   {% note orange 'fas fa-battery-half' disabled %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note purple 'far fa-hand-scissors' disabled %}剪刀石头布{% endnote %}
   
   {% note green 'fab fa-internet-explorer' disabled %}前端最讨厌的浏览器{% endnote %}

5. no-icon样式

   {% note no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note blue no-icon %}2021年快到了....{% endnote %}
   
   {% note pink no-icon %}小心开车 安全至上{% endnote %}
   
   {% note red no-icon %}这是三片呢？还是四片？{% endnote %}
   
   {% note orange no-icon %}你是刷 Visa 还是 UnionPay{% endnote %}
   
   {% note purple no-icon %}剪刀石头布{% endnote %}
   
   {% note green no-icon %}前端最讨厌的浏览器{% endnote %}

行内文本样式 text

• 样例预览
• 标签语法
• 示例源码

1. 带 下划线 的文本
2. 带着重号的文本
3. 带波浪线的文本
4. 带 删除线 的文本
5. 键盘样式的文本 command + D
6. 密码样式的文本：这里没有验证码

{% 下划线 %}
{% emp 着重号 %}
{% wavy 波浪线 %}
{% del 删除线 %}
{% kbd 键盘样式的文本 %}
{% psw 密码样式的文本 %}
{% code 文本内容 %}

1. 带 {% u 下划线 %} 的文本
2. 带 {% emp 着重号 %} 的文本
3. 带 {% wavy 波浪线 %} 的文本
4. 带 {% del 删除线 %} 的文本
5. 键盘样式的文本 {% kbd command %} + {% kbd D %}
6. 密码样式的文本：{% psw 这里没有验证码 %}
7. 代码样式的文本：{% code 这是一个代码块 %}

行内文本 span

• 样例预览
• 标签语法
• 配置参数
• 示例源码

• 彩色文字
  在一段话中方便插入各种颜色的标签，包括：红色、黄色、绿色、青色、蓝色、灰色。
• 超大号文字
  文档「开始」页面中的标题部分就是超大号文字。
  Volantis
  A Wonderful Theme for Hexo

{% span 颜色, 文本内容 %}

字体: logo, code
颜色: red,yellow,green,cyan,blue,gray
大小: small, h4, h3, h2, h1, large, huge, ultra
对齐方向: left, center, right

- 彩色文字
在一段话中方便插入各种颜色的标签，包括：{% span red, 红色 %}、{% span yellow, 黄色 %}、{% span green, 绿色 %}、{% span cyan, 青色 %}、{% span blue, 蓝色 %}、{% span gray, 灰色 %}。
- 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
{% span center logo large, Silvan %}
{% span center small, hello world! %}

段落文本 p

• 样例预览
• 标签语法
• 配置参数
• 示例源码

段落1

段落2

段落3

段落4

段落5

段落6

{% p 样式参数(参数以空格划分), 文本内容 %}

字体: logo, code
颜色: red,yellow,green,cyan,blue,gray
大小: small, h4, h3, h2, h1, large, huge, ultra
对齐方向: left, center, right

{% p red,   段落1 %}
{% p yellow,段落2 %}
{% p green, 段落3 %}
{% p cyan,  段落4 %}
{% p blue,  段落5 %}
{% p gray,  段落6 %}

复选列表 checkbox

• 样例预览
• 标签语法
• 配置参数
• 示例源码

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色 + 默认选中

黄色 + 默认选中

青色 + 默认选中

蓝色 + 默认选中

增加

减少

叉

{% checkbox 样式参数（可选）, 文本（支持简单md） %}

颜色: red,yellow,green,cyan,blue,gray
选中状态: checked

{% checkbox 纯文本测试 %}
{% checkbox checked, 支持简单的 [markdown](https://guides.github.com/features/mastering-markdown/) 语法 %}
{% checkbox red, 支持自定义颜色 %}
{% checkbox green checked, 绿色 + 默认选中 %}
{% checkbox yellow checked, 黄色 + 默认选中 %}
{% checkbox cyan checked, 青色 + 默认选中 %}
{% checkbox blue checked, 蓝色 + 默认选中 %}
{% checkbox plus green checked, 增加 %}
{% checkbox minus yellow checked, 减少 %}
{% checkbox times red checked, 叉 %}

单选列表 radio

• 样例预览
• 标签语法
• 配置参数
• 示例源码

纯文本测试

支持简单的 markdown 语法

支持自定义颜色

绿色

黄色

青色

蓝色

{% radio 样式参数（可选）, 文本（支持简单md） %}

颜色：red,yellow,green,cyan,blue,gray
选中状态：checked

{% radio 纯文本测试 %}
{% radio checked, 支持简单的 [markdown](https://guides.github.com/features/mastering-markdown/) 语法 %}
{% radio red, 支持自定义颜色 %}
{% radio green, 绿色 %}
{% radio yellow, 黄色 %}
{% radio cyan, 青色 %}
{% radio blue, 蓝色 %}

时间轴 timeline

• 样例预览
• 标签语法
• 示例源码

时间轴样式

2020-07-24 2.6.6 -> 3.0

1. 如果有 hexo-lazyload-image 插件，需要删除并重新安装最新版本，设置 lazyload.isSPA: true。
2. 2.x 版本的 css 和 js 不适用于 3.x 版本，如果使用了 use_cdn: true 则需要删除。
3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
4. 2.x 版本的置顶 top: true 改为了 pin: true，并且同样适用于 layout: page 的页面。
5. 如果使用了 hexo-offline 插件，建议卸载，3.0 版本默认开启了 pjax 服务。

2020-05-15 2.6.3 -> 2.6.6

不需要额外处理。

2020-04-20 2.6.2 -> 2.6.3

1. 全局搜索 seotitle 并替换为 seo_title。
2. group 组件的索引规则有变，使用 group 组件的文章内，group: group_name 对应的组件名必须是 group_name。
3. group 组件的列表名优先显示文章的 short_title 其次是 title。

{% timeline 时间线标题（可选）[,color] %}
<!-- timeline 时间节点（标题） -->
正文内容
<!-- endtimeline -->
<!-- timeline 时间节点（标题） -->
正文内容
<!-- endtimeline -->
{% endtimeline %}
<!-- endtab -->
<!-- tab 参数配置 -->
|参数|解释|
|--|--|
|title|标题/时间线|
|color|{% span yello,timeline%} 颜色：default(留空)/blue/pink/red/purple/orange/green|

时间轴样式

2020-07-24 2.6.6 -> 3.0

1. 如果有 hexo-lazyload-image 插件，需要删除并重新安装最新版本，设置 lazyload.isSPA: true。
2. 2.x 版本的 css 和 js 不适用于 3.x 版本，如果使用了 use_cdn: true 则需要删除。
3. 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
4. 2.x 版本的置顶 top: true 改为了 pin: true，并且同样适用于 layout: page 的页面。
5. 如果使用了 hexo-offline 插件，建议卸载，3.0 版本默认开启了 pjax 服务。

2020-05-15 2.6.3 -> 2.6.6

不需要额外处理。

2020-04-20 2.6.2 -> 2.6.3

1. 全局搜索 seotitle 并替换为 seo_title。
2. group 组件的索引规则有变，使用 group 组件的文章内，group: group_name 对应的组件名必须是 group_name。
3. group 组件的列表名优先显示文章的 short_title 其次是 title。

网站卡片 sites

• 样例预览
• 标签语法
• 示例源码

xaoxuu简约风格

inkss这是一段关于这个网站的描述文字

MHuiG这是一段关于这个网站的描述文字

Colsrch这是一段关于这个网站的描述文字

Linhk1606这是一段关于这个网站的描述文字

{% sitegroup %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接（可选）, description=描述（可选） %}
{% site 标题, url=链接, screenshot=截图链接, avatar=头像链接（可选）, description=描述（可选） %}
{% endsitegroup %}

{% sitegroup %}
{% site xaoxuu, url=https://xaoxuu.com, screenshot=https://i.loli.net/2020/08/21/VuSwWZ1xAeUHEBC.jpg, avatar=https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png, description=简约风格 %}
{% site inkss, url=https://inkss.cn, screenshot=https://i.loli.net/2020/08/21/Vzbu3i8fXs6Nh5Y.jpg, avatar=https://cdn.jsdelivr.net/gh/inkss/common@master/static/web/avatar.jpg, description=这是一段关于这个网站的描述文字 %}
{% site MHuiG, url=https://blog.mhuig.top, screenshot=https://i.loli.net/2020/08/22/d24zpPlhLYWX6D1.png, avatar=https://cdn.jsdelivr.net/gh/MHuiG/imgbed@master/data/p.png, description=这是一段关于这个网站的描述文字 %}
{% site Colsrch, url=https://colsrch.top, screenshot=https://i.loli.net/2020/08/22/dFRWXm52OVu8qfK.png, avatar=https://cdn.jsdelivr.net/gh/Colsrch/images/Colsrch/avatar.jpg, description=这是一段关于这个网站的描述文字 %}
{% site Linhk1606, url=https://linhk1606.github.io, screenshot=https://i.loli.net/2020/08/21/3PmGLCKicnfow1x.png, avatar=https://i.loli.net/2020/02/09/PN7I5RJfFtA93r2.png, description=这是一段关于这个网站的描述文字 %}
{% endsitegroup %}

行内图片 inlineimage

• 样式预览
• 标签语法
• 参数配置
• 示例源码

这是 一段话。

这又是 一段话。

{% inlineimage 图片链接, height=高度（可选） %}

高度：height=20px（可选）

这是 {% inlineimage https://img95.699pic.com/element/40107/1479.png_860.png %} 一段话。

这又是 {% inlineimage https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/aru-l/5150.gif, height=40px %} 一段话。

单张图片 image

• 样式预览
• 标签语法
• 参数配置
• 示例源码

1. 添加描述：
   

   每天下课回宿舍的路，没有什么故事。
2. 指定宽度：
   
3. 指定宽度并添加描述：
   

   每天下课回宿舍的路，没有什么故事。
4. 设置占位背景色：
   

   优化不同宽度浏览的观感

{% image 链接, width=宽度（可选）, height=高度（可选）, alt=描述（可选）, bg=占位颜色（可选） %}

1. 图片宽度高度：width=300px, height=32px
2. 图片描述：alt=图片描述（butterfly需要在主题配置文件中开启图片描述）
3. 占位背景色：bg=#f2f2f2

1. 添加描述：

   {% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, alt=每天下课回宿舍的路，没有什么故事。 %}

2. 指定宽度：

   {% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px %}

3. 指定宽度并添加描述：

   {% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px, alt=每天下课回宿舍的路，没有什么故事。 %}

4. 设置占位背景色：

   {% image https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper-minimalist/2020/025.jpg, width=400px, bg=#1D0C04, alt=优化不同宽度浏览的观感 %}

音频audio

• 样式预览
• 标签语法
• 示例源码

{% audio 链接 %}

{% audio https://github.com/volantis-x/volantis-docs/releases/download/assets/Lumia1020.mp3 %}

折叠框folding

• 样式预览
• 标签语法
• 参数配置
• 示例源码

查看图片测试

查看默认打开的折叠框

这是一个默认打开的折叠框。

查看代码测试

假装这里有代码块（代码块没法嵌套代码块）

查看列表测试

• haha
• hehe

查看嵌套测试

查看嵌套测试2

查看嵌套测试3

hahaha

{% folding 参数（可选）, 标题 %}
![](https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg)
{% endfolding %}

1. 颜色：cyan, green, yello, red, blue
2. 标题：标题
3. 打开状态：open

{% folding 查看图片测试 %}

![](https://cdn.jsdelivr.net/gh/volantis-x/cdn-wallpaper/abstract/41F215B9-261F-48B4-80B5-4E86E165259E.jpeg)

{% endfolding %}

{% folding cyan open, 查看默认打开的折叠框 %}

这是一个默认打开的折叠框。

{% endfolding %}

{% folding green, 查看代码测试 %}
假装这里有代码块（代码块没法嵌套代码块）
{% endfolding %}

{% folding yellow, 查看列表测试 %}

- haha
- hehe

{% endfolding %}

{% folding red, 查看嵌套测试 %}

{% folding blue, 查看嵌套测试2 %}

{% folding 查看嵌套测试3 %}

hahaha <span><img src='https://cdn.jsdelivr.net/gh/volantis-x/cdn-emoji/tieba/%E6%BB%91%E7%A8%BD.png' style='height:24px'></span>

{% endfolding %}

{% endfolding %}

{% endfolding %}

链接卡片 link

• 样式预览
• 标签语法
• 示例源码

糖果屋教程贴

https://akilar.top/posts/615e2dec/

{% link 标题, 链接, 图片链接（可选） %}

{% link 糖果屋教程贴, https://akilar.top/posts/615e2dec/, https://cdn.cbd.int/akilar-candyassets@1.0.36/image/siteicon/favicon.ico %}

按钮 btns

• 样式预览
• 标签语法
• 参数配置
• 示例源码

1. 如果需要显示类似[团队成员]之类含有头像的链接

xaoxuu xaoxuu xaoxuu xaoxuu xaoxuu

1. 或者含有图标的按钮

下载源码 查看文档

1. 圆形图标+标题+描述+图片+网格五列+居中
   心率管家

   专业版

   心率管家

   免费版

   

{% btns 样式参数 %}
{% cell 标题, 链接, 图片或者图标 %}
{% cell 标题, 链接, 图片或者图标 %}
{% endbtns %}

1. 圆角样式：rounded, circle
2. 增加文字样式：可以在容器内增加 <b>标题</b>和<p>描述文字</p>
3. 布局方式：默认为自动宽度，适合视野内只有一两个的情况。

参数	含义
wide	宽一点的按钮
fill	填充布局，自动铺满至少一行，多了会换行
center	居中，按钮之间是固定间距
around	居中分散
grid2	等宽最多2列，屏幕变窄会适当减少列数
grid3	等宽最多3列，屏幕变窄会适当减少列数
grid4	等宽最多4列，屏幕变窄会适当减少列数
grid5	等宽最多5列，屏幕变窄会适当减少列数

1. 如果需要显示类似[团队成员]之类含有头像的链接

   {% btns circle grid5 %}
   {% cell xaoxuu, https://xaoxuu.com, https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png %}
   {% cell xaoxuu, https://xaoxuu.com, https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png %}
   {% cell xaoxuu, https://xaoxuu.com, https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png %}
   {% cell xaoxuu, https://xaoxuu.com, https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png %}
   {% cell xaoxuu, https://xaoxuu.com, https://cdn.jsdelivr.net/gh/xaoxuu/cdn-assets/avatar/avatar.png %}
   {% endbtns %}

2. 或者含有图标的按钮

   {% btns rounded grid5 %}
   {% cell 下载源码, /, fas fa-download %}
   {% cell 查看文档, /, fas fa-book-open %}
   {% endbtns %}

3. 圆形图标+标题+描述+图片+网格五列+居中

   {% btns circle center grid5 %}
   <a href='https://apps.apple.com/cn/app/heart-mate-pro-hrm-utility/id1463348922?ls=1'>
     <i class='fab fa-apple'></i>
     <b>心率管家</b>
     {% p red, 专业版 %}
     <img src='https://cdn.jsdelivr.net/gh/fomalhaut1998/cdn-assets/qrcode/heartmate_pro.png'>
   </a>
   <a href='https://apps.apple.com/cn/app/heart-mate-lite-hrm-utility/id1475747930?ls=1'>
     <i class='fab fa-apple'></i>
     <b>心率管家</b>
     {% p green, 免费版 %}
     <img src='https://cdn.jsdelivr.net/gh/fomalhaut1998/cdn-assets/qrcode/heartmate_lite.png'>
   </a>
   {% endbtns %}

分栏 tab

• 样式预览
• 示例源码

1. Demo 1 - 预设选择第一个【默认】
   • testa1 1
   • testa1 2
   • testa1 3

   This is Tab 1.

   This is Tab 2.

   This is Tab 3.

   1. Demo 2 - 预设选择tabs
   • testa2 1
   • testa2 2
   • testa2 3

   This is Tab 1.

   This is Tab 2.

   This is Tab 3.

   1. Demo 3 - 没有预设值
   • test3 1
   • test3 2
   • test3 3

   This is Tab 1.

   This is Tab 2.

   This is Tab 3.

   1. Demo 4 - 自定义Tab名 + 只有icon + icon和Tab名
   • 第一个Tab
   • 炸弹

   tab名字为第一个Tab

   只有图标 没有Tab名字

   名字+icon

1. Demo 1 - 预设选择第一个【默认】

   {% tabs testa1 %}
   <!-- tab -->
   **This is Tab 1.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 2.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 3.**
   <!-- endtab -->
   {% endtabs %}

2. Demo 2 - 预设选择tabs

   {% tabs testa2, 3 %}
   <!-- tab -->
   **This is Tab 1.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 2.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 3.**
   <!-- endtab -->
   {% endtabs %}

3. Demo 3 - 没有预设值

   {% tabs test3, -1 %}
   <!-- tab -->
   **This is Tab 1.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 2.**
   <!-- endtab -->
   
   <!-- tab -->
   **This is Tab 3.**
   <!-- endtab -->
   {% endtabs %}

4. Demo 4 - 自定义Tab名 + 只有icon + icon和Tab名

   {% tabs test4 %}
   <!-- tab 第一个Tab -->
   **tab名字为第一个Tab**
   <!-- endtab -->
   
   <!-- tab @fab fa-apple-pay -->
   **只有图标 没有Tab名字**
   <!-- endtab -->
   
   <!-- tab 炸弹@fas fa-bomb -->
   **名字+icon**
   <!-- endtab -->
   {% endtabs %}

上标标签 tip

• 样式预览
• 标签语法
• 参数配置
• 示例源码

default

info

success

error

warning

bolt

ban

home

sync

cogs

key

bell

自定义font awesome图标

{% tip [参数，可选] %}文本内容{% endtip %}

• 样式: success,error,warning,bolt,ban,home,sync,cogs,key,bell
• 自定义图标: 支持fontawesome。

{% tip %}default{% endtip %}
{% tip info %}info{% endtip %}
{% tip success %}success{% endtip %}
{% tip error %}error{% endtip %}
{% tip warning %}warning{% endtip %}
{% tip bolt %}bolt{% endtip %}
{% tip ban %}ban{% endtip %}
{% tip home %}home{% endtip %}
{% tip sync %}sync{% endtip %}
{% tip cogs %}cogs{% endtip %}
{% tip key %}key{% endtip %}
{% tip bell %}bell{% endtip %}
{% tip fa-atom %}自定义font awesome图标{% endtip %}

动态标签 anima

• 样式预览
• 参数配置
• 示例源码

文本内容

1. 将所需的CSS类添加到图标（或DOM中的任何元素）。
2. 对于父级悬停样式，需要给目标元素添加指定CSS类，同时还要给目标元素的父级元素添加CSS类faa-parent animated-hover。（详情见示例及示例源码）
   You can regulate the speed of the animation by adding the CSS class or . faa-fastfaa-slow
3. 可以通过给目标元素添加CSS类faa-fast或faa-slow来控制动画快慢。

1. On DOM load（当页面加载时显示动画）

   {% tip warning faa-horizontal animated %}warning{% endtip %}
   {% tip ban faa-flash animated %}ban{% endtip %}

2. 调整动画速度

   {% tip warning faa-horizontal animated faa-fast %}warning{% endtip %}
   {% tip ban faa-flash animated faa-slow %}ban{% endtip %}

3. On hover（当鼠标悬停时显示动画）

   {% tip warning faa-horizontal animated-hover %}warning{% endtip %}
   {% tip ban faa-flash animated-hover %}ban{% endtip %}

4. On parent hover（当鼠标悬停时显示动画）

   {% tip warning faa-parent animated-hover %}<p class="faa-horizontal">warning</p>{% endtip %}
   {% tip ban faa-parent animated-hover %}<p class="faa-flash">ban</p>{% endtip %}

诗词标签poem

• 样式预览
• 标签语法
• 参数配置
• 示例源码

水调歌头

苏轼

丙辰中秋，欢饮达旦，大醉，作此篇，兼怀子由。
明月几时有？把酒问青天。
不知天上宫阙，今夕是何年？
我欲乘风归去，又恐琼楼玉宇，高处不胜寒。
起舞弄清影，何似在人间？

转朱阁，低绮户，照无眠。
不应有恨，何事长向别时圆？
人有悲欢离合，月有阴晴圆缺，此事古难全。
但愿人长久，千里共婵娟。

{% poem [title],[author] %}
诗词内容
{% endpoem %}

1. 标题：title
2. 作者：author

{% poem 水调歌头,苏轼 %}
丙辰中秋，欢饮达旦，大醉，作此篇，兼怀子由。
明月几时有？把酒问青天。
不知天上宫阙，今夕是何年？
我欲乘风归去，又恐琼楼玉宇，高处不胜寒。
起舞弄清影，何似在人间？

转朱阁，低绮户，照无眠。
不应有恨，何事长向别时圆？
人有悲欢离合，月有阴晴圆缺，此事古难全。
但愿人长久，千里共婵娟。
{% endpoem %}

阿里图标

本标签的图标需要自己先从阿里图标库里引入到项目里

• 样式预览
• 标签语法
• 参数配置
• 示例源码

{% icon [icon-xxxx],[font-size] %}

1. icon-xxxx：表示图标font-class
2. font-size：表示图标大小，直接填写数字即可，单位为em。图标大小默认值为1em。

{% icon icon-dongtai1 ,4%}
{% icon icon-dongtai ,4%}
{% icon icon-shipin_niunai,4 %}
{% icon icon-niunai ,4%}
{% icon icon-icon-a-homezhuyefangzijia,4 %}

进度条

• 样式预览
• 标签语法
• 参数配置
• 示例源码

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

进度条样式预览

{% progress [width] [color] [text] %}

1. width：表示进度条宽度，直接填写数字即可，单位为%。进度条宽度默认值为100%。
2. color：表示进度条颜色，可选值为red、yellow、green、cyan、blue、gray。进度条颜色默认值为blue。
3. text：表示进度条文字。

{% progress 10 red 进度条样式预览 %}
{% progress 30 yellow 进度条样式预览 %}
{% progress 50 green 进度条样式预览 %}
{% progress 70 cyan 进度条样式预览 %}
{% progress 90 blue 进度条样式预览 %}
{% progress 100 gray 进度条样式预览 %}

气泡注释

• 样式预览
• 标签语法
• 参数配置
• 示例源码

最近我学到了不少新玩意儿（虽然对很多大佬来说这些已经是旧技术了），比如CSS的兄弟相邻选择器例如 h1 + p {margin-top:50px;}</span>，flex布局Flex 是 Flexible Box 的缩写，意为弹性布局”，用来为盒状模型提供最大的灵活性”</span>，transform变换transform 属性向元素应用 2D 或 3D 转换。该属性允许我们对元素进行旋转、缩放、移动或倾斜。</span>，animation的贝塞尔速度曲线贝塞尔曲线(Bézier curve)，又称贝兹曲线或贝济埃曲线，是应用于二维图形应用程序的数学曲线。一般的矢量图形软件通过它来精确画出曲线，贝兹曲线由线段与节点组成，节点是可拖动的支点，线段像可伸缩的皮筋</span>写法，还有今天刚看到的clip-pathclip-path属性使用裁剪方式创建元素的可显示区域。区域内的部分显示，区域外的隐藏。</span>属性。这些对我来说很新颖的概念狠狠的冲击着我以前积累起来的设计思路。

{% bubble [content] , [notation] ,[background-color] %}

1. content：表示气泡注释内容。
2. notation：表示气泡注释文字。
3. background-color：表示气泡注释背景颜色，可选值为red、yellow、green、cyan、blue、gray。气泡注释背景颜色默认值为blue。

最近我学到了不少新玩意儿（虽然对很多大佬来说这些已经是旧技术了），比如CSS的{% bubble 兄弟相邻选择器,"例如 h1 + p {margin-top:50px;}" %}，{% bubble flex布局,"Flex 是 Flexible Box 的缩写，意为"弹性布局"，用来为盒状模型提供最大的灵活性","#ec5830" %}，{% bubble transform变换,"transform 属性向元素应用 2D 或 3D 转换。该属性允许我们对元素进行旋转、缩放、移动或倾斜。","#1db675" %}，animation的{% bubble 贝塞尔速度曲线,"贝塞尔曲线(Bézier curve)，又称贝兹曲线或贝济埃曲线，是应用于二维图形应用程序的数学曲线。一般的矢量图形软件通过它来精确画出曲线，贝兹曲线由线段与节点组成，节点是可拖动的支点，线段像可伸缩的皮筋","#de4489" %}写法，还有今天刚看到的{% bubble clip-path,"clip-path属性使用裁剪方式创建元素的可显示区域。区域内的部分显示，区域外的隐藏。","#868fd7" %}属性。这些对我来说很新颖的概念狠狠的冲击着我以前积累起来的设计思路。

其他

• 旋转相册
• 上标标签 tip
• 动态标签 anima
• 链接卡片 link
• 按钮 btns
• github卡片 ghcard
• github徽标 ghbdage
• 视频 video
• 相册 gallery
• 特效标签 wow
• 注释