Markdown使用指南

2022年11月11日

我的第一篇博客，从刚学来的markdown开始

标题

1.分级标题

====上面一行的内容就是一级标题
—-上面一行的内容就是二级标题
====或—-都要单独一行

这是一个一级标题
============================
这是一个二级标题
----------------------------

第二种写法
用#放标题最前面，几个#表示是几级标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2.斜体和粗体

代码

*斜体*或_斜体_
**粗体**
***加粗斜体***
~~删除线~~

显示效果

这是一段斜体

这是一段粗体

这是一段加粗斜体

~~这是一段删除线~~

3.超链接

Markdown 支持两种形式的链接语法：行内式和参考式两种形式。

3.1 行内式

[链接名](链接地址 “链接的title属性”)
链接的title属性可以不加

1 2	欢迎来到[重庆理工大学](https://www.cqut.edu.cn/) 欢迎来到[重庆理工大学](https://www.cqut.edu.cn/ "重庆理工大学")

显示效果

欢迎来到重庆理工大学

3.2 参考式

利用变量的形式
/[链接名][链接变量名]

一般用在学术论文上

当某个链接在文章中多处使用的时候，也可以使用参考式超链接，会很方便

比如说[CQUT][1]、[Google][g]

[1]:https://www.cqut.edu.cn "CQUT"
[g]:http://www.google.com "Google"

显示效果

比如说CQUT、Google

3.3 自动连接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用<>包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

1	<https://www.cqut.edu.cn/>

显示效果

https://www.cqut.edu.cn/

4.列表

4.1 无序列表

使用 *，+，- 表示无序列表。

1
2
3

- 哈哈
- 嘿嘿
- 嘻嘻

显示效果

哈哈
嘿嘿
嘻嘻

4.2 有序列表

有序列表则使用数字接着一个英文句点。

1
2
3

1. 嘿嘿
2. 哈哈
3. 嘻嘻

显示效果

嘿嘿
哈哈
嘻嘻

4.3 列表缩进

- 轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。 
那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 
软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！
- 那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 
寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。 
但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ 
悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。

显示效果

轻轻的我走了，正如我轻轻的来；我轻轻的招手，作别西天的云彩。
那河畔的金柳，是夕阳中的新娘；波光里的艳影，在我的心头荡漾。
软泥上的青荇，油油的在水底招摇；在康河的柔波里，我甘心做一条水草！
那榆荫下的一潭，不是清泉，是天上虹；揉碎在浮藻间，沉淀着彩虹似的梦。
寻梦？撑一支长篙，向青草更青处漫溯；满载一船星辉，在星辉斑斓里放歌。
但我不能放歌，悄悄是别离的笙箫；夏虫也为我沉默，沉默是今晚的康桥！
悄悄的我走了，正如我悄悄的来；我挥一挥衣袖，不带走一片云彩。

4.4 包含段落的列表

*   轻轻的我走了， 正如我轻轻的来； 我轻轻的招手， 作别西天的云彩。
那河畔的金柳， 是夕阳中的新娘； 波光里的艳影， 在我的心头荡漾。 
软泥上的青荇， 油油的在水底招摇； 在康河的柔波里， 我甘心做一条水草！

    那榆荫下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻间， 沉淀着彩虹似的梦。 
寻梦？撑一支长篙， 向青草更青处漫溯； 满载一船星辉， 在星辉斑斓里放歌。 
但我不能放歌， 悄悄是别离的笙箫； 夏虫也为我沉默， 沉默是今晚的康桥！ 
*    悄悄的我走了， 正如我悄悄的来； 我挥一挥衣袖， 不带走一片云彩。

显示效果

轻轻的我走了，正如我轻轻的来；我轻轻的招手，作别西天的云彩。
那河畔的金柳，是夕阳中的新娘；波光里的艳影，在我的心头荡漾。
软泥上的青荇，油油的在水底招摇；在康河的柔波里，我甘心做一条水草！

那榆荫下的一潭，不是清泉，是天上虹；揉碎在浮藻间，沉淀着彩虹似的梦。
寻梦？撑一支长篙，向青草更青处漫溯；满载一船星辉，在星辉斑斓里放歌。
但我不能放歌，悄悄是别离的笙箫；夏虫也为我沉默，沉默是今晚的康桥！
悄悄的我走了，正如我悄悄的来；我挥一挥衣袖，不带走一片云彩。

4.5 列表嵌套

* 无序1
    1. 有序1
    2. 有序2
        - 无序3
    3. 有序3
* 无序2
    - 无序4

显示效果

无序1
1. 有序1
2. 有序2
  - 无序3
3. 有序3
无序2
- 无序4

5.区块引用

>这是一个区块引用

显示效果

这是一个区块引用

还可嵌套引用

5.1 嵌套列表

>- 嵌套无序列表
>- haha

>1. 嵌套有序列表
>2.xixi

显示效果

嵌套无序列表

haha

嵌套有序列表

xixi

5.2 嵌套代码

1
2
3

>代码
>
>       return 0;

显示效果

代码

  return 0;

6.图像

与超链接用法相似

6.1 行内式

1	![花花](http://xtzl.wentexl.cn/ljw/bjt/b0002.jpg)

显示效果

6.2 参考式

1 2	![花花][f] [f]:http://xtzl.wentexl.cn/ljw/bjt/b0002.jpg "花花"

显示效果

7.注脚

在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。然后在文本的任意位置(一般在最后)添加脚注，脚注前必须有对应的脚注名字。

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。

[^1]:Markdown是一种纯文本标记语言

[^2]:HyperTextMarkupLanguage超文本标记语言

[^Le]:开源笔记平台，支持Markdown和笔记直接发为博文

显示效果

使用 Markdown^1可以效率的书写文档, 直接转换成 HTML^2, 你可以使用 Leanote^Le 编辑器进行书写。

8.引用公式

$表示行内公式 $$表示整行公式

一元二次方程$y=ax^2+bx+c$

显示效果

一元二次方程$y=ax^2+bx+c$

1 2	$$y=ax^2+bx+c$$ $$x=x+1$$

显示效果
$$y=ax^2+bx+c$$
$$x=x+1$$

9.表格

不管是哪种方式，第一行为表头，第二行分隔表头和主体部分，第三行开始每一行为一个表格行。
列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。

第二行还可以为不同的列指定对齐方向。默认为左对齐，在-右边加上:就右对齐。

普通格式
|表头|表头|
|-|-|
|1|单元格|
|2|表格|

简单格式
|表头|表头|
-|-
|1|单元格|
|2|表格|

对齐
|左对齐|右对齐|居中对齐|
:-|-:|:-:
|1|单元格|表格|
|2|表格|单元格|

显示效果

普通格式

表头	表头
1	单元格
2	表格

简单格式

表头	表头
1	单元格
2	表格

对齐

左对齐	右对齐	居中对齐
1	单元格	表格
2	表格	单元格

10.分隔线

用三个及以上的*-_以及空格组成，显示效果都一样

***
* * *
*****
- - -
----------

显示效果

11.代码

对于程序员来说这个功能是必不可少的，插入程序代码的方式有两种，一种是利用缩进(Tab), 另一种是利用”`”符号（一般在ESC键下方）包裹代码。

11.1 行内式

记得`return 0`

显示效果

记得return 0

11.2 多行代码

利用缩进或者是用``````包裹代码

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

显示效果

#include <stdio.h>
int main(void)
{
    printf("Hello world\n");
}

11.3 直接引用HTML

1	<div>这是一个块</div>

显示效果

这是一个块

11.4 转义引用

可以用反斜杠打印特殊符号，如：

\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号