Markdown 语法和 Butterfly 的外挂标签
参考来源: Fomalhaut’s Blog
我对内容进行了重新排版、分类,并且修改了一点细节,简化了一部分内容;大部分内容还是来自原博客。
1. Markdown 自带语法
1.1 标题
1 | # Title 1 |
会破坏目录,先不放了
可以参考 【Markdown语法】字体颜色大小及文字底色设置_markdown中怎么写颜色-CSDN博客
1.2 代码块
1 | ```Python |
1 | print("Hello World!") |
1.3 文字样式
1 | Type: ** bold ** |
Type: bold
Type: italic
Type: Highlight
Type: deleted
下划线
4号字 黑体 蓝色这里的背景色是:LightSeaGreen,此处输入任意想输入的内容 |
1.4 排版
1 | > 做网站的人只要考虑做网站就行了, |
做网站的人只要考虑做网站就行了,
后面忘了
前面也忘了
这里有两条线,一条是分割线,另一条也是分割线
1.5 列表
1.5.1 无序列表
1 | - 我觉得减号最顺手 |
- 我觉得减号最顺手
- 所以在这里写一点东西吧
- 其他懒得写了!
- 效果相同
- 1
- 1
- 都是无序列表
- 1
- 1
1.5.2 有序列表
Fun fact: 我用 vscode 显示的是5,但是 typora 自动变成了4
1 | 1. 你好 |
- 你好
- 我有一个顺序
- 这是第3个
- 这是第4个
1.6 图片
1 | // 本地图片 |
// 本地图片
// 在线图片
1.7 表格
1 | |项目标号|资金|备注| |
项目标号 | 资金 | 备注 |
---|---|---|
1 | 100 | 无 |
2 | 200 | 无 |
3 | 1145 | 重要 |
1.8 公式
1 | $$ |
2. Butterfly 外挂标签
2.1 文本样式
2.1.1 行内文本样式
1 | 带 {% u 下划线 %} 的文本 |
无
带 下划线 的文本
带
带
带 删除线 的文本
键盘样式的文本 Ctrl + C
密码样式的文本:
2.1.2 行内文本样式 (span)
1 | - 彩色文字 |
字体
: logo, code颜色
: red, yellow, green, cyan, blue, gray, black大小
: small, h4, h3, h2, h1, large, huge, ultra对齐方向
: left, center, right
- 彩色文字
在一段话中方便地插入各种颜色的标签:阳、光、彩、虹、小、白、马。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。
《没有呀》
By Boybook
2.1.3 段落文本样式 (p)
1 | - 彩色文字 |
字体
: logo, code颜色
: red, yellow, green, cyan, blue, gray, black大小
: small, h4, h3, h2, h1, large, huge, ultra对齐方向
: left, center, right
- 彩色文字
在一段话中方便地插入各种颜色的标签:阳
、光
、彩
、虹
、小
、白
、马
。 - 超大号文字
文档「开始」页面中的标题部分就是超大号文字。《没有呀》
By Boybook
2.2 引用 (note)
自带 icon 版
1.simple
样式1
2
3
4
5
6
7
8
9
10
11
12
13{% 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.flat
样式1
2
3
4
5
6
7
8
9
10
11
12
13{% 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 %}
3.modern
样式1
2
3
4
5
6
7
8
9
10
11
12
13{% 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 %}
4.no-icon
样式1
2
3
4
5
6
7
8
9
10
11
12
13{% 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 %}
5.disabled
样式1
2
3
4
5
6
7
8
9
10
11
12
13{% 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 %}
外部 icon 版
1 | {% note 'fab fa-cc-visa' simple %}你是刷 Visa 还是 UnionPay{% endnote %} |
1.自带 icon
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 (default/primary/success/info/warning/danger) |
no-icon | 【可选】不显示 icon |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
2.外部 icon
参数 | 用法 |
---|---|
class | 【可选】标识,不同的标识有不同的配色 (default/blue/pink/red/purple/orange/green) |
no-icon | 【可选】可配置自定义 icon (只支持 fontawesome 图标, 也可以配置 no-icon) |
style | 【可选】可以覆盖配置中的 style (simple/modern/flat/disabled) |
自带 icon 版
1.simple
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
2.flat
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
3.modern
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
4.no-icon
样式
5.disabled
样式
默认 提示块标签
default 提示块标签
primary 提示块标签
success 提示块标签
info 提示块标签
warning 提示块标签
danger 提示块标签
外部 icon 版
你是刷 Visa 还是 UnionPay
Dream away (Hylen Remix).mp3
___,___!___,___!……
这是三片呢?还是四片?
50% - 慢速充电中
剪刀石头布
前端最讨厌的浏览器
2.3 上标标签 (tip)
2.3.1 静态标签
1 | {% tip %}default{% endtip %} |
样式
: success, error, warning, bolt, ban, home, sync, cogs, key, bell
default
info
success
error
warning
bolt
ban
home
sync
cogs
key
bell
支持自定义 font awesome 图标
2.3.2 动态标签
1.直接显示动画1
2{% tip warning faa-horizontal animated %}warning{% endtip %}
{% tip ban faa-flash animated %}ban{% endtip %}
2.鼠标悬停时显示动画1
2{% tip warning faa-horizontal animated-hover %}warning{% endtip %}
{% tip ban faa-flash animated-hover %}ban{% endtip %}
3.鼠标悬停在父级元素时显示动画1
2{% 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 %}
速度
: faa-fast, faa-slow (加在animated的后面,例如animated faa-slow
)
- 对于父级悬停样式,需要给目标元素添加指定CSS类,同时还要给目标元素的父级元素添加CSS类
faa-parent animated-hover
。
1.直接显示动画
warning
ban
2.鼠标悬停时显示动画
warning
ban
3.鼠标悬停在父级元素时显示动画
warning
ban
2.3.3 特效标签 (wow)
1 | {% wow animate__zoomIn,5s,5s,100,10 %} |
1 | {% wow animate__slideInRight,5s,5s %} |
1 | {% wow animate__heartBeat,,5s,,10 %} |
1 | {% wow animete, duration, delay, offset, iteration %} |
animate
: 动画样式,效果详见animate.css参考文档duration
: 【可选】动画持续时间,单位可以是ms
也可以是s
delay
: 【可选】动画开始的延迟时间,单位可以是ms
也可以是s
offset
: 【可选】开始动画的距离(相对浏览器底部)iteration
: 【可选】动画重复的次数
zoomIn
动画效果,持续5s
,延时5s
,离底部100
距离时启动,重复10
次
heartBeat
动画效果,延时5s
,重复10
次。
2.4 列表
2.4.1 单选列表 (radio)
1 | {% radio 默认 %} |
颜色
: red, yellow, green, cyan, blue, gray选中状态
: checked
2.4.2 复选列表 (checkbox)
1 | {% checkbox 默认 %} |
样式
: plus, minus, times颜色
: red, yellow, green, cyan, blue, gray选中状态
: checked
2.5 时间轴 (timeline)
1 | {% timeline 时间轴样式,blue %} |
颜色
: red, yellow, green, cyan, blue, gray
时间轴样式
2020-07-24 2.6.6 -> 3.0
- 如果有
hexo-lazyload-image
插件,需要删除并重新安装最新版本,设置lazyload.isSPA: true
。 - 2.x 版本的 css 和 js 不适用于 3.x 版本,如果使用了
use_cdn: true
则需要删除。 - 2.x 版本的 fancybox 标签在 3.x 版本中被重命名为 gallery 。
- 2.x 版本的置顶
top: true
改为了pin: true
,并且同样适用于layout: page
的页面。 - 如果使用了
hexo-offline
插件,建议卸载,3.0 版本默认开启了 pjax 服务。
2020-05-15 2.6.3 -> 2.6.6
不需要额外处理。
2020-04-20 2.6.2 -> 2.6.3
- 全局搜索
seotitle
并替换为seo_title
。 - group 组件的索引规则有变,使用 group 组件的文章内,
group: group_name
对应的组件名必须是group_name
。 - group 组件的列表名优先显示文章的
short_title
其次是title
。
2.6 按钮 (btns)
1 | {% btns circle grid5 %} |
- 可以居中或添加文字
1 | {% btns circle center grid5 %} |
圆角样式
:rounded, circle增加文字样式
:可以在容器内增加<b>
标题</b>
和<p>
描述文字</p>
等布局方式
:wide, fill, center, around, grid
参数 | 含义 |
---|---|
wide | 按钮变宽 |
fill | 填充布局,自动铺满至少一行,多了会自动换行 |
center | 居中,按钮之间固定间距 |
around | 居中分散 |
grid2 | 等宽最多2列,屏幕变窄会适当减少列数 |
grid3 | 等宽最多3列,屏幕变窄会适当减少列数 |
grid4 | 等宽最多4列,屏幕变窄会适当减少列数 |
grid5 | 等宽最多5列,屏幕变窄会适当减少列数 |
2.7 卡片
2.7.1 链接卡片 (link)
1 | {% link Osu!, https://osu.ppy.sh/, https://s2.loli.net/2024/06/05/WZhSoAGgtUP14Rc.png %} |
无
2.7.2 Github 卡片 (ghcard)
1.用户信息卡片1
{% ghcard winter7zowo, theme=vue %}
2.仓库信息卡片1
{% ghcard volantis-x/hexo-theme-volantis, theme=vue %}
使用,
分割各个参数。写法为:参数=取值
以下只写几个常用参数值。
参数 | 取值 | 释义 |
---|---|---|
hide | stars, commits, prs, issues, contribs | 隐藏指定统计 |
count_private | true | 将私人项目贡献添加到总提交计数中 |
show_icons | true | 显示图标 |
theme | 查阅:Available Themes | 主题 |
2.7.3 网站卡片 (sites)
1 | {% sitegroup %} |
无
2.8 Github 徽标 (ghbadge)
1 | {% bdage Source,GitHub,GitHub||,https://github.com/ %} |
1 | {% bdage [right],[left],[logo]||[color],[link],[title]||[option] %} |
left
:徽标左边的信息right
: 徽标右边的信息logo
:【可选】徽标图标,图标名称详见simpleiconscolor
:【可选】徽标右边的颜色link
:【可选】指向的链接title
:【可选】徽标的额外信息。主要用于优化SEO,但object标签不会像a标签一样在鼠标悬停显示title信息option
:【可选】自定义参数,支持shields.io的全部API参数,格式为name1=value2&name2=value2
2.9 图片
2.9.1 单张图片 (image)
1 | {% image https://s2.loli.net/2024/05/17/UlVN36nLJku17CP.png, width=400px, bg=#1D0C04, alt=背景色 %} |
width
/height
: 单位为 pxalt
: 图片描述(butterfly需要在主题配置文件中开启图片描述)bg
: 背景色,格式为 #ffffff
2.9.2 行内图片 (inlineimage)
1 | 点一下{% inlineimage https://s2.loli.net/2024/05/27/NScj2omAPBEHWUY.gif, height=18px %},他就会动 |
height
: 【可选】单位为 px
点一下,他就会动
2.10 音频 (audio)
1 | {% audio https://b.ppy.sh/preview/2141601.mp3 %} |
无
2.11 视频 (video)
1 | {% videos, 2 %} |
对齐方向
:left, center, right列数
:逗号后面直接写列数,支持 1 ~ 4 列
效果就是一个播放器,应该不用演示吧,先不放了
2.12 相册 (gallery)
1.gallerygroup
相册图库1
2
3<div class="gallery-group-main">
{% galleryGroup 画猜 神秘相册 '/gallery/DG/' https://s2.loli.net/2024/05/17/UlVN36nLJku17CP.png %}
</div>
2.gallery
相册1
2
3{% gallery %}

{% endgallery %}
- gallerygroup 相册图库
1 | {% galleryGroup name description link img-url %} |
参数 | 释义 |
---|---|
name | 图库名字 |
description | 图库描述 |
link | 链接到对应相册的地址 |
img-url | 图库封面 |
gallery 相册
区别于旧版的Gallery相册,新的Gallery相册会自动根据图片长度进行排版,书写也更加方便,与markdown格式一样。可以根据需要插入到相应的md。无需再自己配置长宽。建议在粘贴时故意使用长短、大小、横竖不一的图片,会有更好的效果。(尺寸完全相同的图片只会平铺输出,效果很糟糕)
2.13 折叠框 (folding)
1 | {% folding cyan open, 查看默认打开的折叠框 %} |
颜色
:blue, cyan, green, yellow, red状态
:状态填写 open 代表默认打开。
查看默认打开的折叠框
这是一个默认打开的折叠框。
折叠框颜色可选
可以嵌套
可以嵌套
可以嵌套
可以嵌套
可以嵌套
never gonna give you up
2.14 分栏 (tab)
- 默认
1
2
3
4
5
6
7
8
9{% tabs test1 %}
<!-- tab -->
**This is Tab 1.**
<!-- endtab -->
<!-- tab -->
**This is Tab 2.**
<!-- endtab -->
{% endtabs %} - 预设选择 Tab 2 & 自定义 Tab 名
1
2
3
4
5
6
7
8
9{% tabs test2, 2 %}
<!-- tab 分栏 1 -->
**This is Tab 1.**
<!-- endtab -->
<!-- tab 分栏 2-->
**This is Tab 2.**
<!-- endtab -->
{% endtabs %} - 没有预设值 + 自定义 icon
1
2
3
4
5
6
7
8
9{% tabs test3, -1 %}
<!-- tab 炸弹@fas fa-bomb -->
你 17 张牌能秒我?给阿姨倒一杯卡布奇诺
<!-- endtab -->
<!-- tab @fab fa-apple-pay-->
很高冷,不写 Tab 名
<!-- endtab -->
{% endtabs %}
1 | {% tabs Title, index %} |
index
: 【可选】展示的分栏,默认为1。如果为-1,则不会选择任何选项卡subtitle
: 【可选】未指定标题则会按 标题 + 顺序 的格式自动生成。如果指定了 icon 但是标题为空,则标题不会自动生成。icon
: FontAwesome图标名称
- 默认
This is Tab 1.
This is Tab 2.
- 预设选择 Tab 2 & 自定义 Tab 名
This is Tab 1.
This is Tab 2.
- 没有预设值 + 自定义 icon
你 17 张牌能秒我?
给阿姨倒一杯卡布奇诺!
很高冷,不写 Tab 名
2.15 进度条 (progress)
1 | {% progress 1 gray 正在使用百度网盘SVIP加速 %} |
进度
: 0-100, 整数颜色
: red, yellow, green, cyan, blue, gray
2.16 隐藏块 (hideBlock)
1 | {% hideBlock 不要点我, blue %} |
1 | {% hideBlock display, bg, color %} |
display
:【可选】按钮显示的文字bg
:【可选】按钮的填充颜色color
:【可选】文字的颜色
2.17 诗词格式 (poem)
1 | {% poem 水调歌头, 苏轼 %} |
无
丙辰中秋,欢饮达旦,大醉,作此篇,兼怀子由。
明月几时有?把酒问青天。
不知天上宫阙,今夕是何年?
我欲乘风归去,又恐琼楼玉宇,高处不胜寒。
起舞弄清影,何似在人间?
转朱阁,低绮户,照无眠。
不应有恨,何事长向别时圆?
人有悲欢离合,月有阴晴圆缺,此事古难全。
但愿人长久,千里共婵娟。
2.18 注释 (notation)
1 | {% nota 把鼠标移动到我上面试试, 可以看到注解内容出现在顶栏(虽然不太明显) %} |
无
把鼠标移动到我上面试试
2.19 PDF展示 (pdf)
1 | # 1.本地文件:在md文件路径下创建一个同名文件夹,其内放pdf文件名为xxx.pdf的文件 |
无
不演示了
2.20 地图 (map)
1 | {% map 120.101101,30.239119 %} |
地图名 | 标签值 <必填> | 宽 (默认 100%) / 高 (默认 360px) | 缩放等级 (默认 14) | 宽 (默认 100%) / 高 (默认 360px) | 默认图层 (默认 1) |
---|---|---|---|---|---|
混合地图 | map | 百分数或具体值 (100% 或 360px) | 取值 3~18 | 百分数或具体值 (100% 或 360px) | 取值 1~7 |
谷歌地图 | googleMap | 百分数或具体值 (100% 或 360px) | 取值 1~20 | 百分数或具体值 (100% 或 360px) | 取值 1~3 |
高德地图 | gaodeMap | 百分数或具体值 (100% 或 360px) | 取值 3~18 | 百分数或具体值 (100% 或 360px) | 取值 1~3 |
百度地图 | baiduMap | 百分数或具体值 (100% 或 360px) | 取值 4~18 | 百分数或具体值 (100% 或 360px) | 取值 1~2 |
Geoq 地图 | geoqMap | 百分数或具体值 (100% 或 360px) | 取值 1~18 | 百分数或具体值 (100% 或 360px) | 取值 1~5 |
openstreet 地图 | openstreetMap | 百分数或具体值 (100% 或 360px) | 取值 1~18 | 百分数或具体值 (100% 或 360px) | 不支持此参数 |
- 参数之间,用英文逗号相隔
- 参数必须按上述事例顺序输入,不得为空
- 同一个页面,同一组经纬度值,只能插入一个相同标签值的地图 (若有需要,可以将第二个地图上,经度或纬度末尾删除一两个数)
- 参数取值必须在上述范围内
- 默认图层:即地图叠加层的值,默认常规地图还是卫星地图,可按地图显示顺序取值
- 缩放等级,数字越大,地图比例尺越小,显示的越精细
- 除标签值外,其他参数选填,但 每个参数的左边的参数必填
坐标获取:高德地图坐标拾取系统 、百度地图坐标拾取系统
不演示了
2.21 阿里图标 (icon)
1 | {% icon icon, font-size %} |
icon-xxxx
: 表示图标font-class,可以在自己的阿里矢量图标库项目的
font-class`引用方案内查询并复制。font-size
: 表示图标大小,直接填写数字即可,单位为em
。图标大小默认值为1em
。
不演示了