Markdown 语法手册
1、粗体和斜体
代码:
1.*斜体*或_斜体_
2.**粗体**
3.***加粗斜体***
4.~~删除线~~
显示效果:
- 这是一段斜体
- 这是一段粗体
- 这是一段加粗斜体
删除线
2、分级标题
代码:
1.# 一级标题 #
2.## 二级标题 ##
3.### 三级标题 ###
4.#### 四级标题 ####
显示效果:
一级标题
二级标题
三级标题
四级标题
3、超链接
Markdown 支持两种形式的链接语法:行内式和参考式两种形式,行内式一般使用较多
3.1 行内式
语法说明:
- []里写链接文字
- ()里写链接地址,()中的“”中可以写为链接指定的title属性,title属性不是必须填写,当鼠标停留在连接上会显示出title文字。
代码:
1.欢迎来到[www.peter-zhou.com](http://www.peter-zhou.com)
2.
3.欢迎来到[周先生的博客](http://www.peter-zhou.com "周先生的博客")
显示效果:
欢迎来到周先生的博客
3.2 参考式
语法说明: 参考式链接分为两部分
- 文中的写法[链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 "链接标题",链接地址与链接标题之间相隔一个空格
- 如果链接文字本身可以作为链接标记,你也可以写成[链接文字][],[链接文字]:链接地址的形式,见代码的最后一行
代码:
1.我经常去的网站,[www.peter-zhou.com][1],[周先生][2],以及[周先生的博客][]是一个不错的网站
2.
3.[1]:http://www.peter-zhou.com "peter-zhou"
4.[2]:http://www.peter-zhou.com "周先生"
5.[周先生的博客]:http://www.peter-zhou.com
显示效果:
我经常去的网站,www.peter-zhou.com,周先生,以及周先生的博客是一个不错的网站
3.3 自动链接
语法说明: Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用<>包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样
代码:
1.<http://www.peter-zhou.com>
2.<address@peter-zhou.com>
显示效果:
http://www.peter-zhou.com address@peter-zhou.com
4、锚点
5、列表
5.1 无序列表
使用 *,+,- 表示无序列表。
代码:
1. - 无序列表 1
2. - 无序列表 2
3. - 无序列表 3
显示效果:
- 无序列表 1
- 无序列表 2
- 无序列表 3
5.2有序列表
有序列表使用数字接一个英文句点。
代码:
1. 1. 有序列表 1
2. 2. 有序列表 2
3. 3. 有序列表 3
显示效果:
- 有序列表 1
- 有序列表 2
- 有序列表 3
5.3 列表嵌套
代码:
1. - 无序列表 1
2. 1. 有序列表 1
3. 2. 有序列表 2
4. - 无序列表 2
5. - 无序列表 1
6. - 无序列表 2
显示效果:
- 无序列表 1
- 有序列表 1
- 有序列表 2
- 无序列表 2
- 无序列表 1
- 无序列表 2
6、引用
语法说明:引用需要在被引用的文本前加上>符号。
代码:
1. >这是一个有两段文字的引用,
2. >无意义的占行文字1.
3. >无意义的占行文字2.
4. >
5. >无意义的占行文字3.
6. >无意义的占行文字4.
显示效果:
这是一个有两段文字的引用, 无意义的占行文字1. 无意义的占行文字2.
无意义的占行文字3. 无意义的占行文字4.
6.1 引用的多层嵌套
区块引用可以嵌套(例如:引用内的引用),只要根据不同的层次加上不同数量的>
代码:
1.>>> 请问 xxx 怎么样? - 小白
2.>>
3.>> http://xxx - xx客服
4.>
5.> 感觉不错 - 小白
显示效果:
请问 xxx 怎么样? - 小白
http://xxx - xx客服
感觉不错 - 小白
7、插入图像
图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。
语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来替代图片。图片的Title则和链接中的Title一样。表示鼠标悬停与图片上时出现的文字。Alt 和Title都不是必须的。
7.1 行内式
语法说明: 
代码:
1.xxx:
2.
显示效果:
xxx:
7.2 参考式
语法说明: 在文档要插入图片的地方写 ![图片][标记] 在文档的最后写上[标记]:图片地址 "title"
代码:
1.xxx:
2.![xxx][logo]
3.
4.[logo]:http://xxx/logo.png "xxx"
显示效果:
8、内容目录
9、表格
语法说明:
- 不管是哪一种方式,第一行为表头,第二行分割表头和主体部分,第三行开始为每一行表格行
- 列与列之间用管道 | 隔开。原生方式的表格每一行的两边也要有管道
- 第二行还可以为不同的列指定对其方向。默认为左对其,在-右边加上:就右对齐。
代码: 简单写法:
1.学号|姓名|分数
2.-|-|-
3.小红|女|90
4.小明|男|88
5.小白|男|91
原生态写法:
1.|学号|姓名|分数|
2.|-|-|-|
3.|小红|女|90|
4.|小明|男|88|
5.|小白|男|91|
指定对其方式:
1.平台|效果
2.-:|-
3.普通直播(yy语音,腾讯课堂等)| 一般
4.1对1上课| 非常好
效果: 简单写法:
学号 | 姓名 | 分数 |
---|---|---|
小红 | 女 | 90 |
小明 | 男 | 88 |
小白 | 男 | 91 |
原生态写法:
学号 | 姓名 | 分数 |
---|---|---|
小红 | 女 | 90 |
小明 | 男 | 88 |
小白 | 男 | 91 |
指定对其方式:
平台 | 效果 |
---|---|
普通直播(yy语音,腾讯课堂等) | 一般 |
1对1上课 | 非常好 |
10、分割线
你可以在一行中用三个以上的 星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。
代码:
1. * * *
2.
3.***
4.
5.*****
6.
7.- - -
8.
9. -----------------------
效果都一样都是:
11、代码
对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab),另一种是利用"`"(反引号)包裹代码 语法说明:
- 插入行内代码,即插入一个单词或者一句代码的情况,使用
code
这样的形式插入。 - 插入多行代码,可以使用缩进或者"
code
"
11.1 行内式
代码:
1.C语言里的函数scanf()
怎么使用?
显示效果:
C语言里的函数scanf()
怎么使用?
11.2 缩进式多行代码
缩进4个空格或是1个制表符
代码:
1. #include <stdio.h>
2. int main(void)
3. {
4. printf("周先生的博客\n");
5. }
显示效果:
#include <stdio.h>
int main(void)
{
printf("周先生的博客\n");
}
11.3 六个`包裹多行代码
代码:
1.```
2.#include<stdio.h>
3.int main(void)
4.{
5. printf("周先生的博客");
6.}
7.```
显示效果:
#include <stdio.h>
int main(void)
{
printf("周先生的博客");
}
12、复选框
代码:
1.- 未完成事项
2.- [ ] 买车
3.- [ ] 买房
4.- [ ] 娶媳妇
5.
6.- 已完成事项
7.- [x] 都完成,在梦里
显示效果:
- 未完成事项
- [ ] 买车
- [ ] 买房
- [ ] 娶媳妇
- 已完成事项
- [x] 都完成,在梦里