本博客文章均使用markdown编写,以下是部分markdown语法。
一、标题
标题与html中的h标签类似,想要设置为标题的文字前面加#来表示
一个#是一级标题,二个#是二级标题,以此类推。支持六级标题。
注:标准语法一般在#后跟个空格再写文字,
示例:
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
效果如下:
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
二、字体
加粗
要加粗的文字左右分别用两个*号包起来
斜体
要倾斜的文字左右分别用一个*号或者用_包起来
斜体加粗
要倾斜和加粗的文字左右分别用三个*号包起来
删除线
要加删除线的文字左右分别用两个~~号包起来
下划线
下划线可以通过 HTML 的 <u>
标签来实现
脚注
脚注是对文本的补充说明
脚注的格式如下[^alt]:text
示例:
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
<u>带下划线文本</u>
这是一个脚注示例[^饮夏]
[^饮夏]:你好,这里是饮夏
效果如下:
这是加粗的文字
这是倾斜的文字`
这是斜体加粗的文字
这是加删除线的文字
带下划线文本
三、引用
在要引用的文字前加>即可。引用可嵌套
示例:
>这是引用的内容
>>这是引用的内容
>>>这是引用的内容
效果如下:
这是引用的内容
这是引用的内容
这是引用的内容
四、分割线
三个或者三个以上的 - 或者 * 都可以。
示例:
***
---
效果如下:
*
显示效果是没有区别的。
五、图片
语法:
![图片alt](图片地址 ''图片title'')
图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加
六、超链接
语法:
[超链接名](超链接地址 "超链接title")
title可加可不加
示例:
[饮夏](https://yocoh.cn)
效果如下:
七、列表
无序列表
语法:
- 列表内容
+ 列表内容
* 列表内容
注意:- + * 跟内容之间都要有一个空格
效果如下:
- 列表内容
- 列表内容
- 列表内容
有序列表
语法:
1. 列表内容
2. 列表内容
3. 列表内容
注意:序号跟内容之间要有空格
效果如下:
- 列表内容
- 列表内容
- 列表内容
列表嵌套
上一级与下一级之间加上tab
语法:
+ 一级无序列表
+ 二级无序列表
+ 二级
+ 三级
显示效果如下:
- 一级无序列表
- 二级无序列表
- 二级
- 三级
八、表格
语法:
|表头|表头|表头|
|---|:--:|---:|
|内容|内容|内容|
|内容|内容|内容|
第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加:表示文字居中
-右边加:表示文字居右
效果如下:
表头 | 表头 | 表头 |
---|---|---|
第一行 | 第一行 | 第一行 |
第二行 | 第二行 | 第二行 |
第三行 | 第三行 | 第三行 |
九、代码
语法:
单行代码:代码之间分别用一个`包起来
代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行,也可以用一个制表符或四个空格。
示例:
`这是单行代码`
```
这是代码块
```
显示效果如下:
这是单行代码
这是代码块
十、其他:
段落:
段落的换行是使用两个以上空格加上回车,也可以直接用空行来换行。区别如下:
这是使用空格加回车
的换行效果
这是使用空行
的换行效果
支持的HTML元素
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有:<kbd>
<b>
<i>
<em>
<sup>
<sub>
<br>
等
如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑
显示效果如下:
使用 Ctrl+Alt+Del 重启电脑
转义
Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符:
**文本加粗**
\*\* 正常显示星号 \*\*
显示效果如下:
文本加粗
** 正常显示星号 **
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+ 加号
- 减号
. 英文句点
! 感叹号
公式
当需要在编辑器中插入数学公式时,可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后,问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染。如:
$$
w_0\ =\sqrt{\frac{\lambda}{\pi}}\ \frac{\left[L\left(R_1-L\right)\left(R_2-L\right)\left(R_1+R_2-L\right)\right]^\frac{1}{4}}{\left(R_1+R_2-2L\right)^{1/2}}
$$
Spoiler
自定义了一个标签<sp>
来实现扰流板功能,调用方式:
<sp>spoiler</sp>
效果如下:
正文插入音乐
使用hexo-tag-aplayer 来插入音乐
<!-- 简单示例 (id, server, type) -->
{ meting "26201898" "netease" "song" %}
前后都应有百分号,懒得写注释规则,前面的删掉了。
<!-- 进阶示例 -->
{ meting "363276397" "netease" "playlist" "mutex:false" "listmaxheight:340px" "preload:none" "theme:#ad7a86"%}
简单示例效果如下:
进阶示例如下:
以下是有关{meting %}
的选项列表:
选项 | 默认值 | 描述 |
---|---|---|
id | 必须值 | 歌曲 id / 播放列表 id / 相册 id / 搜索关键字 |
server | 必须值 | 音乐平台: netease , tencent , kugou , xiami , baidu |
type | 必须值 | song , playlist , album , search , artist |
fixed | false |
开启固定模式 |
mini | false |
开启迷你模式 |
loop | all |
列表循环模式:all , one ,none |
order | list |
列表播放模式: list , random |
volume | 0.7 | 播放器音量 |
lrctype | 0 | 歌词格式类型 |
listfolded | false |
指定音乐播放列表是否折叠 |
storagename | metingjs |
LocalStorage 中存储播放器设定的键名 |
autoplay | true |
自动播放,移动端浏览器暂时不支持此功能 |
mutex | true |
该选项开启时,如果同页面有其他 aplayer 播放,该播放器会暂停 |
listmaxheight | 340px |
播放列表的最大长度 |
preload | auto |
音乐文件预载入模式,可选项: none , metadata , auto |
theme | #ad7a86 |
播放器风格色彩设置 |