markdown

markdown简介

markdown是一种轻量级的「标记语言」，它用简洁的语法代替排版，而不像一般我们用的字处理软件 Word 或 Pages 有大量的排版、字体设置。它使我们专心于码字，用「标记」语法来代替常见的排版格式，它的语法十分简单，常用的标记符号也不超过十个。Markdown 从写作到完成，导出格式随心所欲，你可以导出 HTML 格式的文件用来网站发布，也可以十分方便的导出 PDF 格式。

markdown官方文档

• 创始人 John Gruber 的 Markdown 语法说明
• Markdown 中文版语法说明

使用markdown的优点

• 专注你的文字内容而不是排版样式。
• 轻松的导出 HTML、PDF 和本身的 .md 文件。
• 纯文本内容，兼容所有的文本编辑器与字处理软件。
• 可读，直观。适合所有人的写作语言。

我该用什么工具？

• Mac平台：Mou
• Windows：MarkdownPad，MarkPad等
• IOS：Drafts、Day One、iA Writer 等
• Web端：简书，CSDN

我们公司因为网络的限制推荐用CSDN的markdown编辑器。

markdown简要语法规则

标题

标题是每篇文章都需要也是最常用的格式，在 Markdown 中，如果一段文字被定义为标题，只要在这段文字前加 # 号即可。

# 一级标题
## 二级标题
### 三级标题

以此类推，总共六级标题，建议在井号后加一个空格，这是最标准的 Markdown 语法。

列表

熟悉 HTML 的同学肯定知道有序列表与无序列表的区别，在 Markdown 下，列表的显示只需要在文字前加上 - 或 * 即可变为无序列表，有序列表则直接在文字前加 1. 2. 3. 符号要和文字之间加上一个字符的空格。

引用

如果你需要引用一小段别处的句子，那么就要用引用的格式。只需要在文本前加入 > 这种尖括号（大于号）即可

图片与链接

插入链接与插入图片的语法很像，区别在一个 !号
插入图片的地址需要图床，上传图片到网络上生成URL地址即可。（公司内部似乎限制了网络，很多网站上传操作无法达成，所以推荐使用CSDN的markdown编辑器，这个可以上传）

粗体和斜体

Markdown 的粗体和斜体也非常简单，用两个 * 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。注意 * 号两边不要留空格，否则会当做普通 * 号处理。

表格

表格是 Markdown 比较累人的地方，例子如下：

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

这种语法生成的表格如下：

Tables	Are	Cool
col 3 is	right-aligned	$1600
col 2 is	centered	$12
zebra stripes	are neat	$1

* markdown语法分为标准语法和不同版本的扩展语法，此种类型的表格仅能在扩展语法上使用，标准语法上的表格用HTML标签完成。

代码框

如果你是个程序猿，需要在文章里优雅的引用代码框，在 Markdown 下实现也非常简单，只需要用两个 ` 把中间的代码包裹起来，如 `code`。图例：

如果你想插入代码块，可以使用每行一阶的缩进（4 个空格或是 1 个制表符）插入

这是一个普通段落：
    这是一个代码区块。
    这是一个代码区块。
    这是一个代码区块。

或者，在扩展语法中，可以用两组（每组三个）反引号来插入代码块

```
这是一个代码区块。
这是一个代码区块。
这是一个代码区块。
```

分割线

分割线的语法只需要另起一行，连续输入三个星号 *** 即可。

其他细节

1. 不在 Markdown 涵盖范围之内的HTML标签，都可以直接在文档里面用 HTML 撰写，不需要额外标注这是 HTML 或是 Markdown，只要直接加标签就可以了。
2. 与其它语言类似，反斜线 \ 可以用来转义。