Markdown基础语法教程

1、基础语法

1）标题格式

MarkDown支持6种级别的标题，对应html中的h1~h6,多个#号+空格+标题
# h1
## h2
### h3
#### h4
##### h5
###### h6
带上标记效果如下：

h1

h2

h3

h4

h5

h6

Markdown还支持另外一种标题展现形式，类似于Setext标记语言的表现形式，使用下划线进行文本大小的控制，仅有一级和二级标题
这是一级标题
===
这是二级标题
—
带上标记效果如下：

这是一级标题

这是二级标题

2）段落格式

1）首行缩进

  全角模式下，按两个空格。PS:我也没有实现
  不断行的空格： 或  
  全角的空格： 或  
  半角的空格： 或  

2）换行

同html中的语法<br>

<br>

或者使用两个以上的空格+回车

3）新段落

开启新段落，可以通过在段落后添加一个空行来表示开启一个新段落

4）字体

Markdown可以使用以下几种字体：

*斜体文字*
_斜体文字_
**粗体文字**
__粗体文字__
***粗斜体文字***
___粗斜体文字___

显示效果如下：

---

斜体文字
斜体文字
粗体文字
粗体文字
粗斜体文字
粗斜体文字

5）分割线

可以在一行中通过三个以上的星号、减号或者底线来建立分割线，线内不能有其他内容，可以有在其中冲入空格

***
* * *
***********
---
- - -
-------------
___
_ _ _
______________

显示效果如下：

---

---

---

6）删除线

如果段落的文字要添加删除线，只需要在文字的两端添加两个波浪线~~即可，实例如下：

~~这是删除线~~

显示效果如下：

---

这是删除线

7）下划线

下滑线可以通过HTML的<u>标签来实现:

<u>这是下划线</u>

显示效果如下：

---

这是下划线

8）脚注

脚注是对文本的补充说明，其格式如下：

[^要脚注的文本]

显示效果如下 ¹

3）列表和表格格式

1）无序列表

可以使用(*)、加号(+)或是减号(-)+空格作为列表标记:

* 第一项
* 第二项
* 第三项

- 第一项
- 第二项
- 第三项

+ 第一项
+ 第二项
+ 第三项

显示效果如下：

---

• 第一项
• 第二项
• 第三项

2）有序列表

通过数字+.号+空格表示：

1. 第一项
2. 第二项
3. 第三项

显示效果如下：

1. 第一项
2. 第二项
3. 第三项

3）列表嵌套

列表嵌套只需在子列表中的选项前添加四个空格即可：

1. 第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2.第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素

显示效果如下：

1. 第一项：
   • 第一项嵌套的第一个元素
   • 第一项嵌套的第二个元素
2. 第二项：
   • 第二项嵌套的第一个元素
   • 第二项嵌套的第二个元素

4）表格

Markdown制作表格用|来分割不同的单元格，其中使用-来区分表头行和其他行：

|表头|表头|
|----|----|
|单元格|单元格|
|单元格|单元格|

显示效果如下：

表头	表头
单元格	单元格
单元格	单元格

表格对齐方式：

|左对齐|居中对齐|右对齐|
|：----|：----：|----：|
|单元格|单元格|单元格|
|单元格|单元格|单元格|

显示效果如下：

左对齐	居中对齐	右对齐
单元格	单元格	单元格
单元格	单元格	单元格

4）区块语法

1）区块格式

在段落的开头使用>+一个空格，区块也是可以嵌套的，一个>是最外层，两个>是第一层嵌套，以此类推：

>最外层
>> 第二层
>>> 第三层

显示效果如下：

最外层

第二层

第三层

2）区块中使用列表

> 1. 第一项
> 2. 第二项
> + 第一项
> + 第二项
> + 第三项

显示效果如下：

1. 第一项
2. 第二项

• 第一项
• 第二项
• 第三项

3）列表中使用区块

* 第一项
    > 菜鸟教程
> 学的不仅是技术更是梦想
* 第二项

显示效果如下：

• 第一项

  哈哈哈
  好用的工具

• 第二项

5）代码格式

1）代码片段

在段落中的一个函数或代码片段可以用反引号包起来：

`printf()` 函数

显示效果如下：
printf() 函数

2）代码区块

使用4个空格或者一个制表符（tab键）或者使用 ````包裹一段代码，并指定一种语言

````javascript
$(document).ready(function() {
alert(‘你好’);
});
````

显示效果如下：

$(document).ready(function() {
alert(‘你好’);
});

6. 链接格式

1）基础链接 {#index}

基础链接使用方法如下：

[链接名称](链接)
或者
<链接地址>

显示效果如下：

这是一个链接 百度一下
https://www.baidu.com

2）高级链接

链接也可以用变量来替代，在文档末尾附带变量地址：

文中写法:[链接文字][链接标记]
在文本的任意位置添加[链接标记]:链接地址+空格+“链接标题”
这个链接用1作为网址变量[Google]1
这个链接用 baidu 作为网址变量 [baidu]baidu
然后在文档尾为变量赋值(网址)
 
[1]:http://www.google.com/ “Google”
[baidu]:http://www.baidu.com/ “baidu”

显示效果如下：

这个链接用1作为网址变量Google
这个链接用 baidu 作为网址变量 baidu
然后在文档尾为变量赋值(网址)

3）锚点

锚点就是网页内部跳转链接。
注意：Markdown Extra只支持在标题后插入锚点，其他地方无效

语法：在要跳转到的指定标题添加锚点<div id=“标记”/>，然后走到文档的其他地方写上链接到锚点的链接[位置](#标记)

显示效果如下：
链接格式

7）图片格式

图片的语法格式如下：

开头一个感叹号!
接着一个方括号，放图片的替换文字
接着一个普通括号，放图片URL，还可以添加引号“”放上图片title

![alt 属性文本](图片地址)
![alt 属性文本](图片地址 "可选标题")

显示效果如下：

未完待续…

---

1. 你需要的不仅仅是技术，更是一个梦想。 ↩︎