Markdown入门指南
一、编写Markdown的工具
window系统:MarkdownPad
Mac OS X:Mou
二、Markdown官方文档
三、Markdown简要语法
1.标题
类 Atx 形式:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
类 Setext形式:
最高阶标题
=========
第二阶标题
---------
注意:
* 类Atx形式的标题有六级,类Setext形式的标题只有两级。
* 类Atx形式中,符号与文字之间要间隔一个空格,这是最标准的Markdown语法。
* 类Setext形式中,下面的“=”和“-”数量任意。
2.引用
> 这里是引用语句1
> 这里是引用语句2
> 这里是引用语法3
注意:
* 同样,符号与文字之间要间隔一个空格。
* 可以只在引用区域的开头加上>,然后其它地方的>省略。
* 引用区域内可以使用Markdown语法,包括标题、列表,代码块以及引用本身。
* 如果要结束引用,只需将引用区域与不引用区域隔开一行即可。
3.列表
无序列表:
* 第一项
* 第二项
* 第三项
亦或者
+ 第一项
+ 第二项
+ 第三项
亦或者
- 第一项
- 第二项
- 第三项
锯齿状分级
* 第一项
* 第二项
* 第三项
注意:
* 符号与文字之间要间隔一个空格。
* 如果三项不是左对齐,而是类似于锯齿状的话,那么第一行开头是一个实心圆点,第二行开头是一个空心原点,第三行开头是一个实心方形点,最多分三级。
有序列表
1. 第一项
2. 第二项
3. 第三项
锯齿状分级
1. 第一项
2. 第二项
3. 第三项
- 符号与文字之间要间隔一个空格。
- 如果三项不是左对齐,而是类似于锯齿状的话,那么第二行的序号将会从1开始(无论当前所写的序号是多少),第三行类似,最多分三级。
4.图片与超链接
图片
![测试图片](https://1tpic.com/images/2017/07/15/MarkdownTest.md.jpg)
- 前面的方括号中是图片的名字,后面的圆括号中是图片的链接地址。
- 这是使用了图床来保存图片。常见的免费图床可以参考这篇文章的介绍:盘点好用的免费图床。
超链接
//行内式
[百度](https://www.baidu.com/)
//参考式
[百度][id]
[id]:https://www.baidu.com/ "这是国内一家搜索引擎"
- 行内式前面的方括号中是超链接的名字,后面的圆括号中是超链接的地址。
- 参考式第一行后面的方括号与第二行中方括号的内容要一致,可以是任意内容,只是用来索引地址而已。
- 参考式中的双引号中的内容是鼠标停放在超链接“百度”上时,显示的文字,也可以用圆括号来包裹。
- 参考式第一行和第二号不一定要靠在一起,可以一个放在开头,一个放在结尾。这种方式的引用比行内式更加的简洁好看。
5.斜体与粗体
*斜体*
**粗体**
- 实现斜体的代码中,星号与文字之间不能有空格。而粗体则没有这个限制。
6.表格
|第一列|第二列|第三列|
|:--|---:|:----:|
|七|一|六|
|三|五|九|
|四|八|二|
实现效果:
第一列 | 第二列 | 第三列 |
---|---|---|
七 | 一 | 六 |
三 | 五 | 九 |
四 | 八 | 二 |
* 可以看到,有冒号和横线的那一行,是不会出现在浏览页面中,那一行是用来定义数据展现的样式:居左,居中和居右。冒号在左边是居左,冒号在右边是居右,两边都有冒号则是居中,两边都没有冒号默认居左。横线的数量可以任意。
* 定义行的上面只能有一行,该行则是表格的表头行。
7.分割线
***
8.代码块
“```Markdown
>这里是应用
```”
- 由于不能在代码块中再使用代码块语法,因而这里使用“”括住具体语法,使用时需要将“”去掉。
- 这里的`是英文输入法下,按键盘上1键左边的那个键输入的,而不是单引号。
- 这里的Markdown是指代码块中的代码是Markdown代码,也可以是Java,Ruby等等。
四、Markdown与Html的关系
Markdown兼容Html语法。比如在Markdown中使用html的标签br,同样可以实现在Html中的效果。
但反过来就不行了,不能在Html中使用Markdown语法。
参考:
1. Markdown——入门指南
2. Markdown 语法说明 (简体中文版)