第一部分,markdown 的基本语法部分以及 hexo 的支持效果。

标题

支持 markdown 的各级别标题,效果略。

1
2
3
4
5
# title 1
## title 2
### title 3
#### title 4
##### title 5

列表

注意必须在列表的前面空一行,否则语法解析时无法识别为列表。列表支持嵌套,包括两类列表的混合嵌套。

无序列表

样式一,星号* XX

  • a
  • b
  • c

样式二,减号- XX

  • a
  • b
  • c

样式三,减号+ XX

  • a
  • b
  • c

有序列表

样式一,数学编号1. XX

  1. a
  2. b
  3. c
1
2
3
1. a
2. b
3. c

样式二,全 1 编号1. XX

  1. a
  2. b
  3. c
1
2
3
1. a
1. b
1. c

待办事项

大部分markdown编辑器支持checkbox样式的待办事项

1
2
- [x] TODO 1
- [ ] TODO 2

效果如下

引用

可以用> XX表示引用,支持嵌套引用> > XXX,例如

白日依山尽,黄河入海流

众里寻他千百度,慕然回首,那人却在灯火阑珊处。

注意,hexo 以及 butterfly 主题给引用设置了样式。

字体

  • 一对星号包裹起来,表示斜体,例如*斜体*,效果为: 斜体
  • 两对星号包裹起来,表示加粗,例如**加粗**,效果为:加粗
  • 两对波浪号包裹起来,表示删除,例如~~删除~~,效果为:删除

简单表格

支持 markdown 语法的表格,可以设置左右对齐或居中对齐。

1
2
3
4
| Tittle1 | Tittle2 | Tittle3 |
| :------ | :-----: | ------: |
| Content | Content | Content |
| Content | Content | Content |

效果如下,注意表格前后要留空行。

Tittle1 Tittle2 Tittle3
Content Content Content
Content Content Content

分割线

可以在一行中用三个或以上的星号、减号、底线来建立一个分隔线,行内不能有其他字符,但是不要求连续,中间可以含空格。例如

1
2
3
***
---
___



最好在分割线的前后各留一个空行,防止语法被错误地解析。 可以给分割线提供定制的样式,例如上文的剪刀效果就是 butterfly 主题自带的。

代码

行内的代码使用一对反引号即可(或者更多对也可以),例如printf

1
`printf`

行间的代码块需要使用三对反引号,并且建议标注语言,用于代码高亮。

1
2
3
4
5
6
#include <stdio.h>

int main(){
printf("Hello,world!\n");
return 0;
}

图片

使用基于 GitHub 搭建的图床来存储图片,可以使用标准 markdown 语法来添加图片。

1
![这是一个图片的标题](https://raw.githubusercontent.com/fenglielie/notes_image/main/img/%E4%B8%8D%E5%8F%AF%E5%8E%8B%E6%95%B0%E5%80%BC%E6%96%B9%E6%B3%95%E5%88%86%E7%B1%BB.png)

效果如下:这是一个图片的标题

除了标准的 markdown 语法的图片,同样支持 html 语法的插入图片,这种方式可以指定图片比例(如果同时设置了宽度和高度,以宽度缩放为准)

1
2
3
4
<img
src="https://raw.githubusercontent.com/fenglielie/notes_image/main/img/lagrange.png"
width="50%"
/>

超链接

标准的 markdown 语法。

1
这是一个链接 [显示文本](https://baidu.com "浮动文本")。

效果为: 这是一个链接 显示文本