MarkDown语法说明
written on Sun 27 March 2016 by importcjj
本篇博文参考这里
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。
标题语法
形式一:
标题1
====(至少一个,同行不能有其他字符)
标题2
----
效果:
标题1
标题2
形式二:
示例:
# 标题1 #(可以闭合,也可以不闭合,闭合的话数量也不一定要相同)
## 标题2
### 标题3
#### 标题4
##### 标题5
###### 标题6
效果:
标题1
标题2
标题3
标题4
标题5
标题6
段落和换行
空格
:多个空格或者一个回车符(只能显示一个空格)
多空格
:\
段内换行
:双空格 + 回车符
另起一段
:双回车符
多空行
: \
分隔线语法
三个以上 * 或 - 或 _
* * *
***
*****
- - -
---------------------------------------
效果:
加粗和斜体
使用一个 * 或 _ 来包围词句,相当于用 <em> 标签包围(内部就是这样转化的);
使用两个 * 或 _ 包起来的话,则相当于使用 <strong>。
示例:
**加粗** __加粗__
*斜体* _斜体_
效果:
加粗 加粗
斜体 斜体
列表语法
无序列表
一个星号 / 一个加号 / 一个减号 + 若干个空格 + 列表项内容
条目之间的空行会作用到所有条目
* 条目1 + 条目1 - 条目1
* 条目2 or + 条目2 or - 条目1
* 条目3 + 条目3 - 条目1
效果:
- 条目1
- 条目2
- 条目3
有序列表
一个数字 + 一个英文句点 + 若干个空格 + 列表项内容
1. 条目1
2. 条目2
3. 条目3
33.条目4 (数字可以乱写,自动从1开始排列)
效果:
- 条目1
- 条目2
- 条目3
- 条目4
注意:
-
每个列表条目下都可以包含多个段落,但这些段落都必须缩进 4 个空格或 1 个制表符
-
如果要在列表条目内放进引用,那 > 就需要缩进
-
如果要在列表项内放代码区块的话,该区块就需要缩进两次,也就是8个空格或是2个制表符
区块引用语法
> 引用d段落
(段落里每一行有可以加 > 也可以只在段首加)
效果:
引用段落
引用可以嵌套
示例:
> 父引用
>
> > 子引用
>
> 父引用
效果:
父引用
子引用
父引用
引用内MarkDown语法依然有效
> ## 这是一个标题。
>
> 1. 这是第一个列表项。
> 2. 这是第二个列表项。
>
> 这是一个代码例子:
>
> printf("Hello, Minmin!\n"); return 0;
效果:
这是一个标题。
- 这是第一个列表项。
- 这是第二个列表项。
这是一个代码例子:
printf("Hello, Minmin!\n"); return 0;
链接语法
形式一:自动链接(可点击的URL和Email)
如果链接的文字就是一个网络地址或者是邮箱地址,直接使用<url>
示例:
<https://www.baidu.com>
<importcjj@gmail.com>
形式二:普通文本链接
[链接文字](链接URL ‘可选的链接title’) 注:我的blog有问题,这里的‘ 其实是英文单引号
[链接文字](链接URL "可选的链接title")
[链接文字](链接URL (可选的链接title))
title: 加上title后,你用鼠标移到该链接文字时就会显示title文字,可以把它当作一种提示信息来用
示例:
欢迎光临我的[博客](www.importcjj.com)
效果:
欢迎光临我的博客
形式三:参考式链接
[链接文字][链接id]
\[链接id]: 真正的链接URL "可选的title" 注:去掉反杠!
示例:
[我的博客][id]
\[id]: www.baidu.com "jiaju的博客"
效果: 我的博客
图片语法
![alt文本](https://img10.3lian.com/sc6/show02/67/27/02.jpg)
效果:
代码语法
行内代码
`代码` 反引号
`print "hello world"`
代码区块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以。
表格语法
简洁写法:
示例:
|姓名 |年龄|性别 | 我们可以指定单元格的对齐方式
|--- |----|----- | |:---| 靠左
|John |22 |male | |---| or |:---:| 居中
|Tom |20 |male | |---:| 靠右
|aliss|24 |female|
效果:
姓名 | 年龄 | 性别 |
---|---|---|
John | 22 | male |
Tom | 20 | male |
aliss | 24 | female |
总结
注意:上述乃基本语法,而且由于MarkDown的编辑器各不相同,对于原生MarkDown都有扩展,实际使用的时候情况很多,自己多多尝试就能熟练使用了。