Markdown语法手册

Posted 10月 08 2019. 2293 words. 12 min read.

有关于Markdown语法的总结

前言

Markdown是一种极为简洁的纯文本的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式,而且功能比纯文本强,格式转换方便,能够轻松的到处为HTML、PDF等文件,文件格式为.md格式。

这里推荐使用Typora工具来编辑自己的Markdown文本,因为它可以编辑文本之后实时显示语法效果,有很多方便编辑文本的功能,而且非常的轻量美观,最重要的是免费!

下面所有后面带(typora)标志的为typora内的用法,非标准markdown语法支持,可能在其他不同编辑器里面不会有效果展示, 但是其实很多编辑器都有支持一部分的拓展。

1 基础语法

1.1 分级标题

用法 说明
# 一级标题 一级标题
## 二级标题 二级标题
### 三级标题 三级标题
#### 四级标题 四级标题
##### 五级标题 五级标题
###### 六级标题 六级标题

效果展示:

图片展示

1.2 字体格式

用法 说明
<center>局本</center> 文本居中(typora)
<u>下划线</u> 下划线(typora)
*斜体*_斜体_ 斜体
**粗体** 粗体
***加粗斜体*** 加粗斜体
~~删除线~~ 删除线

效果展示:

<center>局本</center>

下划线

斜体斜体`

粗体

加粗斜体

删除线

1.3 列表

用法 说明
- 无序列表 无序列表
1. 有序列表 下划线
* [x] 已完成 TODO列表已完成(typora)
* [ ] 未完成 TODO列表未完成(typora)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
- 无序列表项 一
- 无序列表项 二
- 无序列表项 三

无序列表嵌套有序列表
- 无序列表项 一
1. 有序列表项 一
2. 有序列表项 二
3. 有序列表项 三
- 无序列表项 二
- 无序列表项
- 无序列表项

* [x] python
* [ ] neroasmar
* [ ] 5AM

效果展示:

  • 无序列表项 1
  • 无序列表项 2
  • 无序列表项 3

无序列表嵌套有序列表

  • 无序列表项 1
    1. 有序列表项 1
    2. 有序列表项 2
    3. 有序列表项 3
  • 无序列表项 2
    • 无序列表项 1
    • 无序列表项 2
  • [x] python
  • [ ] neroasmar
  • [ ] 5AM

1.4 分割线

用法 说明
--- 分割线
*** 分割线
___ 分割线`

效果展示:




1.5 超链接与图片链接

超链接和图片链接的行列式、参考式都是很类似,图片链接只是比URL链接前面多了一个 ! 而已,下面详细讲解这两种链接和两种式子的用法。

1.5.1 超链接

用法 说明
[链接文字](链接地址 "链接标题") 超链接(行列式)
[链接文字][链接标记] 超链接(参考式)
[链接标记]:链接地址 "链接标题" 链接源
  • 链接文字:在文中展示出来的文字
  • 链接地址:超链接地址
  • 链接标题:鼠标悬停在链接文字上后会出现的内容
  • 链接标记:链接源与超链接(参考式)的对应标记
1
2
3
[NEROASMAR](https://neroasmar.top/ "这是我的博客链接")
[Github][1]
[1]: https://github.com/ "这个github链接"

效果展示

NEROASMAR
Github

1.5.2 图片链接

用法 说明
![图片Alt](图片地址 "图片标题") 图片链接(行列式)
![图片Alt][图片标记] 图片链接(参考式)
[图片标记]:图片地址 "图片标题" 链接源
  • 图片Alt:在原图片因为各种原因无法展示出来的时候,代替展示的文字
  • 图片地址:图片地址,可以是网络图片地址和本地图片路径
  • 图片标题:鼠标悬停在图片上后会出现的内容
  • 图片标记:链接源与图片链接(参考式)的对应标记
1
2
3
![四叶草](https://i.loli.net/2019/10/06/PVqBtujklihcwIE.png "这个一个四叶草")
![音符][2]
[2]: https://i.loli.net/2019/10/06/K36lNVs9YGCxkU5.png "这个一个音符"

效果展示

四叶草
音符

1.6 代码

1.6.1 行列式

1
这就是行内式代码`print()`

效果展示

这就是行内式代码print()

1.6.2 多行代码

1
2
3
4
\`\`\`python  # 这里设置语言,这里的反斜杠应该去掉,加上只是为了为了防止转译。
def main():
print("Hello world")
\`\`\`

效果展示

1
2
def main():
print("Hello world")

1.7 引用

1
2
3
4
5
6
7
>这是引用文字  
>>这是多重引用文字
>这是一段无法跳出多层嵌套的文字
>>>这是多重引用文字

>这是第一段引用文字
>这是第二段引用文字

这是引用文字

这是多重引用文字
这是一段无法跳出多层嵌套的文字

这是多重引用文字

这是第一段引用文字
这是第二段引用文字

1.8表格

1
2
3
4
5
6
7
8
9
10
11
|名字|国籍|性别|
|---|:--:|--:|
|小明|中国|男|
|小红|中国|女|
|小刚|美国|男|

# 第一行为表头,第二行分割表头和内容,后面为表内内容
# 第二行中只需要一个 - 就够了,多的只是为了美观对齐
# 其中默认一列为居左
# -两边加:表示文字居中
# -右边加:表示文字居右

效果展示

名字 国籍 性别
小明 中国
小红 中国
小刚 美国

1.9 特殊符号

对于markdown中的语法符号,可以在前面加上反斜杠\就能显示原来的符号本身,而不会被解析为语法符号。

1
2
3
4
5
6
7
8
9
10
11
12
\\    反斜线
\` 反引号
\* 星号
\_ 底线
\{\} 花括号
\[\] 方括号
\(\) 括弧
\# 井号
\+ 加号
\- 减号
\. 英文句点
\! 惊叹号

效果展示

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

2 高级用法

高级用法中的用法大部分需要自己安装相关插件,或者需要相关编辑器支持,请自行搜索相关教程或者通过下面的介绍推荐详细了解。

2.1 流程图

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
\`\`\`flow  # 这里设置为flow,这里的反斜杠应该去掉,加上只是为了为了防止转译。
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
\`\`\`

效果展示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.google.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request

st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e

更多流程图语法可以参考:flowchartmermaidjs

2.2 甘特图

更多甘特图语法参考mermaid

2.3 序列图

更多序列图语法参考brampmermaid

2.4 公式

简单的使用方法为/$插入公式/$ (注:这里的反斜杠应该去掉,加上只是为了为了防止转译。)

比如对于质能守恒公式: E=mc2E=mc^2

更多公式使用方式参考mathjax

2.5 注脚

注脚可以在文章内容中插入额外说明,用法见下:

1
2
3
欢迎来到我的博客[^ 1]欢迎大家留言[^ 2]分享交流!
**效果展示** 欢迎来到我的博客[^ 1]欢迎大家留言[^ 2]分享交流! [^ 1]: 这里是NeroAsmar的博客 [^ 2]: 留言框就在每个文章的最下方 ### 2.6 HTML支持 Markdown里面可以直接将html的标签插入,然后Markdwon会自动处理显示。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<div class="footer">
© 2014 – 2019
</div>

<table>
<tr>
<th>四川</th>
<th>广东</th>
<th>广西</th>
<th>湖南</th>
</tr>
<tr>
<td>成都</td>
<td>广州</td>
<td>南宁</td>
<td>长沙</td>
</tr>
</table>

<font fac = "黑体">这是黑体字</font>
<font color="#009900" size=5 face="黑体">这是html字体</font>

<table><tr><td bgcolor=black>这是黑色背景颜色</td></tr></table>

效果展示

四川 广东 广西 湖南
成都 广州 南宁 长沙

这是黑体字
这是html字体

这是黑色背景颜色

参考

  1. 这里是NeroAsmar的博客

  2. 留言框就在每个文章的最下方


评论