内置Shortcodes
figure
Markdown
中图片语法的扩展
示例
|
|
效果如下

Mercury (figure)
命名参数
参数 | 含义 |
---|---|
src | 图片URL |
link | 图片点击跳转的链接 |
alt | 图片无法显示时的替代文本 |
title | 图片标题 |
caption | 图片说明 |
class | HTML的Class属性 |
height | 图片高度 |
width | 图片宽度 |
attr | 图片归属地 |
attrlink | 图片归属链接 |
gist
Github
gist
的引用
示例
如 gist
链接为:https://github.com/spf13/7896402
则可通过用户名和gist ID嵌入内容
|
|
效果如下
若gist有多个文件且只想引用其中一个文件,则可将该文件名作为第三个参数
|
|
highlight
代码语法高亮
示例
|
|
效果如下
|
|
param
站点参数
示例
|
|
效果如下
Hugo 内置扩展以及 LoveIt 外置扩展使用示例ref与relref
页面跳转链接,通过相对路径(posts/example.md
)或逻辑名称(example.md
)进行查找
注意添加的页面必须是已存在的,否则站点会报错
示例
|
|
效果如下
tweet
推特文章嵌入
示例
添加user用户名和推文URL的ID
|
|
效果如下
Owl bet you'll lose this staring contest 🦉 pic.twitter.com/eJh4f2zncC
— San Diego Zoo Wildlife Alliance (@sandiegozoo) October 26, 2021
vimeo
嵌入来自Vimeo的视频
|
|
效果如下
youtube
嵌入来自YouTube的视频
示例
|
|
效果如下
扩展Shortcodes
style
自定义样式
示例
|
|
效果如下
link
内置的 link
的替代,具备其他功能并可在代码块中使用
参数
参数 | 含义 |
---|---|
href | 链接 |
content | 链接内容 |
title | 标题 |
rel | 补充属性 |
class | class属性 |
示例
|
|
效果如下
无content,显示链接
https://assemble.io带content,显示content
Assemble Assemble鼠标聚焦显示title
Upstage Upstageimage
内置 figure
的替代,充分利用 lazysizes 和 lightGallery 依赖库
参数
参数 | 含义 |
---|---|
src | 图片链接 |
alt | 图片无法显示时的替代文本 |
caption | 图片标题 |
title | 图片聚焦显示提示 |
class | class属性 |
src_s | 图片缩略图URL,用于画廊模式,默认为src |
src_l | 图片高清图URL,用于画廊模式,默认为src |
height | 图片高度 |
width | 图片宽度 |
linked | 图片是否需要被链接,默认为true |
rel | 补充属性,尽在 linked 为true时生效 |
示例
|
|
效果如下

image
)admonition
提示横幅,包含12种样式
参数
- type:样式类型,默认为
note
- title:提示横幅标题,默认为
type
的值 - open:是否展开,默认为
true
type参数列表
参数 | 含义 |
---|---|
note(默认) | 注意 → |
abstract | 摘要 → |
info | 信息 → |
tip | 技巧 → |
success | 成功 → |
question | 问题 → |
warning | 警告 → |
failure | 失败 → |
danger | 危险 → |
bug | Bug → |
example | 示例 → |
quote | 引用 → |
示例
|
|
效果如下
mermaid
使用 Mermaid 库提供绘制图表和流程图的功能
示例
|
|
效果如下
echarts
echarts
shortcode 使用 ECharts 库提供数据可视化的功能
参数
- wdith:数据图宽度,默认100%
- height:数据图高度,默认100%
示例
|
|
效果如下
mapbox
使用 Mapbox GL JS 库提供互动式地图的功能
Mapbox
使用需要在config
中填写access token
Mapbox
注册需要卡号,可用卡号生成器随机绑定一个
参数
参数 | 含义 |
---|---|
lng | 经度 |
lat | 纬度 |
zoom | 初始缩放级别,默认为10 |
marked | 是否在的初始中心点添加图钉,默认为true |
light-style | 浅色主题的地图样式 |
dark-style | 深色主题的地图样式 |
navigation | 缩放按钮和指南针的控件,默认为true |
geolocate | 使用浏览器的地理定位API在地图上定位用户的控件,默认为true |
scale | 放大缩小控件,默认为true |
fullscreen | 全屏控件,默认为true |
width | 地图宽度,默认为100% |
height | 地图高度,默认为20rem |
示例
|
|
效果如下
music
music
基于 APlayer 和 MetingJS 库提供了一个内嵌的响应式音乐播放器
分为本地模式和在线模式
通用参数
参数 | 含义 |
---|---|
theme | 播放器的主题色,默认为#448aff |
fixed | 固定模式,默认为false |
mini | 迷你模式,默认为false |
autoplay | 自动播放,默认为false |
volume | 默认音量,默认为0.7 |
mutex | 自动暂停其他播放器,默认为true |
仅适用于音乐列表模式
参数 | 含义 |
---|---|
loop | 循环模式,默认为none ,可选all 、one |
order | 播放顺序,默认为list ,可选random |
list-folded | 初始列表折叠,默认为false |
list-max-height | 列表最大高度,默认为340px |
本地
参数
- server:链接
- type: 音乐名称
- artist: 创作者
- cover: 封面链接
示例
|
|
在线
自动识别
auto
自动识别 netease
、tencent
、xiami
平台的链接
示例
|
|
效果如下
自定义音乐平台、类型和ID
参数
- server: 音乐平台,支持
netease
、tencent
、kugou
、xiami
、baidu
- type:类型,支持
song
,playlist
,album
,search
,artist
- id: 与
type
对应,歌曲 ID、 播放列表 ID、 专辑 ID、 搜索关键词、 创作者 ID
示例
|
|
效果如下
bilibili
bilibili
内嵌的播放 bilibili 视频的响应式播放器
示例
若视频没有分P,则仅需av
或者bv
作为id
参数
|
|
效果如下
若视频分P,则还需添加p
参数,默认为1
|
|
效果如下
typeit
typeit
shortcode 基于 TypeIt 库提供了打字动画
参数
参数 | 含义 |
---|---|
tag | 包裹的标签名 |
code | 若内容为代码,可指定语言,显示代码块高亮 |
group | 相同group 会按照顺序展示 |
示例
|
|
效果如下
简单示例
script
script
可插入Javascript
脚本
示例
|
|
效果在控制台
raw
raw
可插入HTML
内容
示例
|
|
效果如下
行内公式:
公式块:
原始的带有 Markdown 语法的内容:
person
person
用于插入个人网站链接
参数
参数 | 含义 |
---|---|
url | 链接 |
name | 站长名称 |
text | 鼠标聚焦时弹出的提示 |
picture | 头像链接 |
nick | 昵称 |
示例
|
|
效果如下
