2017.5.15 markdown简明教程

0.说明

markdown是一种书写格式，html是一种发布格式。markdown的语法种类只对应html标记的一小部分（只涵盖纯文本）。

不在markdown涵盖范围的标签，都可以直接在文档里用html书写，不需要格外标注。

一些格式html区块元素：<div> <table> <pre> <p>等，必须在前面加上空行与其他内容隔开，并且开始和结束时不能用空格来缩进。

更详细的教程地址：http://www.appinn.com/markdown/index.html

1.标题

 语法：#+空格+标题文本
 参数：增加一个#，标题增加一级（字号变小），总共有1-6级
 示例：
 # 一级标题
 ## 二级标题

2.强调

2.1 粗体

注意，这里没有空格。

 语法：**+粗体文本+**

2.2 斜体

注意，这里没有空格。

 语法：*+斜体文本+*

2.3 分割线

 语法：单独一行输入***或者---

3.引用

 语法：>+空格+引用文本

4.列表

4.1 有序列表

 语法：数字+英文句号+空格+有序列表文本
 实例：1. 我是文本

4.2 无序列表

 语法：符号（*，+，-）+空格+无序列表文本
 示例：* 我是文本
      - 我是文本
      + 我是文本

5.链接

5.1 行内

 语法：[行内链接显示名](行内链接url地址)
 实例：[这是一个连接](http://baidu.com)

5.2 参考

 作用：在此处为链接定一个名称，之后在文件的其他地方定义该链接的内容
 语法：这是参考链接1[参考链接显示名][参考链接id]
 示例：这是链接1[Google][1]
      [1]: http://google.com/ 

5.3 html标签

markdown支持html语法，所以可以使用html的<a>标签。

 语法：<a href="html标签链接url地址">
 示例：<a href="http://baidu.com">链接名</a>

6.图片

6.1 行内

 语法：![行内图片文本](行内图片地址 "title")
 示例：![代替文本](/path/to/img.jpg "title")

6.2 参考

 作用：在文件其他地方定义该图片
 语法：![参考图片文本][参考图片id]
 示例：![代替文本][1]
      [1]: /path/to/img.jpg "title"

6.3 html标签

markdown支持html语法，所以可以使用html的<img>标签。这样比较方便，因为可以直接调整大小。

 语法：<img src="html标签图片地址" title="标题" width="200px" height="200px“>
 示例：<img src=" /path/to/img.jpg" width="100px">

7.代码

内部的&，<>都会被自动转换成html实体。

7.1 代码区段

 语法：`代码区段`
 反引号：英文输入法下1的左边

7.2 代码区块

每行都缩进一个tab（内部的区块已经是格式化）。

8.反斜杠

 作用：用于插入一些在语法中有其他意义的符号
 语法：\+在语法中有其他意义的符号
 示例：\*这是有意义的符号\*
 效果：*这是有意义的符号*

9.汇总

语法汇总：

 1 #+空格+标题文本
 2 **+粗体文本+**
 3 *+斜体文本+*
 4 ***或者---
 5 >+空格+引用文本
 6
 7 数字+英文句号+空格+有序列表文本
 8 符号（*，+，-）+空格+无序列表文本
 9
10 [行内链接显示名](行内链接url地址)
11 这是参考链接1[参考链接显示名][参考链接id]
12 [1]: http://google.com/
13 <a href="html标签链接url地址">
14
15 ![行内图片文本](行内图片地址 "title")
16 ![参考图片文本][参考图片id]
17 <img src="html标签图片地址" title="标题" width="200px" height="200px“>
18
19 `代码区段`
20     <div>
21         <label />
22     </div>
23
24 \+在语法中有其他意义的符号
     

效果显示：

注意：代码区块前后一定要空行！