Markdown 文档格式编写语法

# Markdown 文档格式编写语法

## ☑ 标题

在MarkdownMate中，标题使用`#+空格+文本`的形式表示。
语法如下：
```
# 1 一级标题
## 1.1 二级标题
### 1.1.1 三级标题
#### 1.1.1.1 四级标题
##### 1.1.1.1.1 五级标题
###### 1.1.1.1.1.1 六级标题
```
效果如下图所示：
![biaoti](images/biaoti.png "title")

## ☑ 代码块
在MarkdownMate中，shell脚本和代码使用前后加```反引号的形式表示。
语法如下：
![daima1](images/daima1.png "title") 
![daima2](images/daima2.png "title")
效果如下：
```
$ sudo gem install
```
```
　　int i = 0;
　　i = 1;
　　for (int i = 0; i < 100; i++)
　　{
　　printf("hello markdown!\n");
　　}
```
如果要标记一小段行内代码，你可以用反引号把它包起来（ ` ），例如：
```
Use the `printf()` function.

```
## ☑ 段落文本
1、首行缩进

写文章时，我们常常希望能够首行缩进，这时可以在段首加入`&ensp;`来输入一个空格.加入`&emsp;`来输入两个空格。

2、粗体与斜体

Markdown 的粗体和斜体也非常简单，用两个 `*`包含一段文本就是粗体的语法，用一个 `*` 包含一段文本就是斜体的语法。

3、回车与换行

在 Markdown 需要换行的话，在插入处先按入三个或三个以上的空格然后回车。

4、有序列表与无序列表

在 Markdown 下，列表的显示只需要在文字前加上`*`即可变为无序列表，有序列表则直接在文字前加`1. 2. 3.` 符号要和文字之间加上一个字符的空格。
语法如下：
```
* Red
* Green
* Blue
```
```
1. Bird
2. McHale
3. Parish
```
效果如下：
![liebiao1](images/liebiao1.png "title")
5、符号转义

如果你的描述中需要用到 markdown 的符号，比如 `_ # *` 等，但又不想它被转义，这时候可以在这些符号前加反斜杠，如 `\_ \# \* `进行避免。

6、引用和连接
如果你需要引用一小段别处的句子，那么就要用引用的格式。只需要在文本前加入 `>` 这种尖括号（大于号）即可 
语法如下： 
`> 这里是引用`
 效果如下： 
> 这里是引用

在MarkdownMate中,使用链接，链接文字都是用 [方括号] 来标记。
语法如下：
```
This is [an example](http://example.com/ "Title") inline link.
```
效果如下： 
This is [an example](http://example.com/ "Title") inline link.
## ☑ 分割线
如果我们想用分割线对内容进行分割，我们可以在单独一行里输入3个或以上的星号来实现。
语法如下：
```
***
```
效果如下：
***

## ☑ 图片

先将需要插入的图片截图保存，然后在 Markdown 需要插入图片的地方输入`![Alt text](/path/to/img.jpg "Optional title")` 例如：刚刚保存的图片名称为CDH1.png，则需要在插入图片的位置输入：`![CDH1.png](images/CDH1.png "title") `即可，待文档编写完毕将图片和文档一起提供给前端负责人员。

***

* ♈ > 在线编写测试工具： http://mahua.jser.me/
* ♈ > 详细语法参考： http://wowubuntu.com/markdown/

posted on 2016-12-14 14:55 Isuty 阅读(289) 评论(0) 编辑收藏举报