Markdown语法手册
1. 格式控制
1.1 粗体/斜体
代码
*斜体*或_斜体_
**粗体**
***加粗斜体***
显示效果
斜体或斜体
粗体
加粗斜体
1.2 字体大小
代码
<font size=4>我是4号字</font>
<small>字体变小</small>
<big>字体变大</big>
<font face="黑体">我是黑体字</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>
显示效果
<font size=4>我是4号字</font>
<small>字体变小</small>
<big>字体变大</big>
<font face="黑体">我是黑体字</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>null</font>
<font color=gray size=5>gray</font>
2. 标题(#后请加空格)
代码
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(最多六级)
显示效果
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题(最多六级)
3. 列表
3.1 有序列表
语法说明
有序列表需要在文字前加1.2.3.
代码
1. 有序列表项1
2. 有序列表项2
3. 有序列表项3
显示效果
- 有序列表项1
- 有序列表项2
- 有序列表项3
3.2 无序列表
语法说明
无序列表需要在文字前加-
或*
代码1
* 无序列表项1
* 无序列表项2
* 无序列表项3
显示效果1
- 无序列表项1
- 无序列表项2
- 无序列表项3
代码2
- 无序列表项1
- 无序列表项2
- 无序列表项3
显示效果2
- 无序列表项1
- 无序列表项2
- 无序列表项3
3.3 列表缩进
语法说明
在每项前加*+tab
代码
* 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥!
* 悄悄的我走了,正如我悄悄的来;我挥一挥衣袖,不带走一片云彩。
显示效果
- 轻轻的我走了, 正如我轻轻的来; 我轻轻的招手, 作别西天的云彩。那河畔的金柳, 是夕阳中的新娘; 波光里的艳影, 在我的心头荡漾。 软泥上的青荇, 油油的在水底招摇; 在康河的柔波里, 我甘心做一条水草!
那榆荫下的一潭, 不是清泉, 是天上虹; 揉碎在浮藻间, 沉淀着彩虹似的梦。
寻梦?撑一支长篙, 向青草更青处漫溯; 满载一船星辉, 在星辉斑斓里放歌。但我不能放歌, 悄悄是别离的笙箫; 夏虫也为我沉默, 沉默是今晚的康桥! - 悄悄的我走了,正如我悄悄的来;我挥一挥衣袖,不带走一片云彩。
3.4 特殊情况
错误代码
I love
1986. What a great year!
错误结果
I love
- What a great year!
正确代码
I love
1986\. What a great year!
正确结果
I love
1986. What a great year!
4. 引用
语法说明
需要在文本前添加>
即可
注意:对于多端文字,可以只在段首添加>
代码
> 这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
>无意义的占行文字3.
无意义的占行文字4.
显示效果
这是一个有两段文字的引用,
无意义的占行文字1.
无意义的占行文字2.
无意义的占行文字3.
无意义的占行文字4.
4.1 引用的多层嵌套
代码
>>> 请问 Markdown 怎么用? - 小白
>> 自己看教程! - 愤青
> 教程在哪? - 小白
显示效果
请问 Markdown 怎么用? - 小白
自己看教程! - 愤青
教程在哪? - 小白
4.2 引用其他要素
引用区块中也可以使用其他Markdown语法。
代码
>1. 这是第一行列表项。
2. 这是第二行列表项。
>给出一些例子代码:
`return shell_exec("echo $input | $markdown_script");`
显示效果
- 这是第一行列表项。
- 这是第二行列表项。
给出一些例子代码:
return shell_exec("echo $input | $markdown_script");
5. 超链接 {#section 5}
Markdown超链接有两种形式:行内式和参考式。其中,行内式使用较多。
5.1 行内式
语法说明
[]中写链接字,()中写链接地址,()中的""部分记录链接的title属性(鼠标放置时显示的字段)。
形式为[链接文字](链接地址 "链接标题")
,其中,链接地址与链接标题之间要有一个空格。
代码
欢迎来到[pdd直播间](https://www.panda.tv/6666)
欢迎来到[pdd直播间](https://www.panda.tv/6666 "pdd直播间地址")
显示效果
欢迎来到pdd直播间
欢迎来到pdd直播间
5.2 参考式
参考式通常使用于学术论文或者某条超链接被多次使用的场合。
语法说明
参考式超链接分为两部分:
文中:[链接文字][链接标记]
任何位置(通常是文末): [链接标记]:链接地址 "链接标题"
如果使用链接文字作为链接标记,书写方式如下:
文中: [链接文字][]
任何位置: [链接文字]:链接地址
代码
娱乐时会选择去[pdd直播间][1]看直播放松;学习时会选择去[我的博客][2]静心钻研; 遇到问题会查询[百度][]; 本文的参考博客来自[梵居闹市的博客]。
[1]: https://www.panda.tv/6666 "pdd直播间地址"
[2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
[3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
[百度]: www.baidu.com "百度"
显示效果
娱乐时会选择去[pdd直播间][1]看直播放松;学习时会选择去[我的博客][2]静心钻研; 遇到问题会查询[百度][]; 本文的参考博客来自[梵居闹市的博客]。
[1]: https://www.panda.tv/6666 "pdd直播间地址"
[2]: http://www.jianshu.com/users/11fbce2586e2/timeline "xuhaowxy的博客"
[3]: http://http://http://blog.leanote.com/post/freewalk/Markdown "梵居闹市"
[百度]: www.baidu.com "百度"
5.3 自动链接
Markdown支持直接把网址或电子邮箱地址转化为超链接。
语法说明
用<链接地址>
,其中如果是网址,必须以http://
开头
代码
我的邮箱地址<xuhaowxy@qq.com>,
我的博客是 <http://www.jianshu.com/users/11fbce2586e2/timeline>
显示效果
我的邮箱地址xuhaowxy@qq.com,
我的博客是 http://www.jianshu.com/users/11fbce2586e2/timeline
5.4 锚点
锚点即超链接的目标位置是本文的其他地方(比如目录),一般用于文内跳转。
语法说明
在跳转目标点添加{#标记}
在其他位置写上[链接文字](#标志)
代码
跳转到[第五章](#section 5)
显示效果
跳转到[第五章](#section 5)
6. 插入图片
插入图片的写法与超链接类似,也分为行内式和参考式两种。
6.1 行内式
语法说明
![](图片地址 "图片标题")
代码
错误图片:
![](图片地址 "图片标题")
美丽花儿:
![美丽花儿](http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿")
显示效果
错误图片:
美丽花儿:
6.2 参考式
语法说明
在文档要插入图片的地方写![图片Alt][标记]
在文档的最后写上[标记]:图片地址 "Title"
代码
美丽花儿:
![美丽花儿][flower]
[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿"
显示效果
美丽花儿:
![美丽花儿][flower]
[flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美丽花儿"
7. 注脚
语法说明
在需要添加注脚的文字后加上脚注名字[^注脚名字],称为加注。 然后在文本的任意位置(一般在最后)添加脚注,脚注前必须有对应的脚注名字。
注意:经测试注脚与注脚之间必须空一行,不然会失效。成功后会发现,即使你没有把注脚写在文末,经Markdown转换后,也会自动归类到文章的最后。
代码
使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Leanote[^Le] 编辑器进行书写。
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^Le]:开源笔记平台,支持Markdown和笔记直接发为博文
显示效果
使用 Markdown[1]可以效率的书写文档, 直接转换成 HTML[2], 你可以使用 Leanote[3] 编辑器进行书写。
8. 公式(写法同LaTeX)
8.1 行内公式
语法说明
$公式$
代码
质能方程为 $E=mc^2$
显示效果
质能方程为 $E=mc^2$
8.2 整行公式
语法说明
$$公式$$
代码
$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}_{k=0}{\widehat{\gamma}_{kj} z_k}$$
显示效果
$$\sum_{i=1}^n a_i=0$$
$$f(x_1,x_x,\ldots,x_n) = x_1^2 + x_2^2 + \cdots + x_n^2 $$
$$\sum^{j-1}{k=0}{\widehat{\gamma}{kj} z_k}$$
9. 表格
语法说明
- 不管是哪种方式,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。
- 列于列之间用管道符|隔开。原生方式的表格每一行的两边也要有管道符。
- 第二行还可以为不同的列指定对齐方向。默认为左对齐,在-右边加上:就右对齐。
代码
简单方式写表格:
学号|姓名|分数
-|-|-
小明|男|75
小红|女|79
小陆|男|92
原生方式写表格:
|学号|姓名|分数|
|-|-|-|
|小明|男|75|
|小红|女|79|
|小陆|男|92|
为表格第二列指定方向:
产品|价格
-|-:
Leanote 高级账号|60元/年
Leanote 超级账号|120元/年
显示效果
简单方式写表格:
学号 | 姓名 | 分数 |
---|---|---|
小明 | 男 | 75 |
小红 | 女 | 79 |
小陆 | 男 | 92 |
原生方式写表格:
学号 | 姓名 | 分数 |
---|---|---|
小明 | 男 | 75 |
小红 | 女 | 79 |
小陆 | 男 | 92 |
为表格第二列指定方向:
产品 | 价格 |
---|---|
Leanote 高级账号 | 60元/年 |
Leanote 超级账号 | 120元/年 |
10. 分隔符
语法说明
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
代码
* * *
***
*****
---------------------------------------
显示效果
11. 代码
对于程序员来说这个功能是必不可少的,插入程序代码的方式有两种,一种是利用缩进(Tab), 另一种是利用”`”符号(一般在ESC键下方)包裹代码。
语法说明
- 插入行内代码,即插入一个单词或者一句代码的情况,使用
code
这样的形式插入。 - 插入多行代码,可以使用缩进或者“
code “
,具体看示例。
注意: 缩进式插入前方必须有空行
11.1 行内代码
代码
C语言里的函数 `scanf()` 怎么使用?
显示效果
C语言里的函数 scanf()
怎么使用?
11.2 多行代码(缩进)
代码
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
显示效果
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
11.3 多行代码(六个`包裹)
代码
```
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
```
显示效果
#include <stdio.h>
int main(void)
{
printf("Hello world\n");
}
11.4 HTML源码
在代码区块里面, & 、 < 和 > 会自动转成 HTML 实体,这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码,只需要复制贴上,剩下的 Markdown 都会帮你处理,例如:
代码
第一个例子:
<div class="footer">
© 2004 Foo Corporation
</div>
第二个例子:
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>
</tr>
</table>
显示效果
第一个例子:
<div class="footer">
© 2004 Foo Corporation
</div>
第二个例子:
<table>
<tr>
<th rowspan="2">值班人员</th>
<th>星期一</th>
<th>星期二</th>
<th>星期三</th>
</tr>
<tr>
<td>李强</td>
<td>张明</td>
<td>王平</td>s
</tr>
</table>