一、前言

Markdown是一種可以使用普通文本編輯器編寫的標(biāo)記語(yǔ)言，通過(guò)簡(jiǎn)單的標(biāo)記語(yǔ)法，它可以使普通文本內(nèi)容具有一定的格式。    --摘自百度百科

沒(méi)想到一向不太靠譜的百度百科這次竟有了如此精辟的解釋。之前項(xiàng)目一直使用word撰寫文檔，有比較大的弊病：

• 只能對(duì)純文本文件進(jìn)行版本控制，而word是二進(jìn)制格式
• 格式繁雜，經(jīng)常需要中斷寫作來(lái)控制格式
• 代碼與文檔分離，給寫文檔造成更大的阻力

而假如單純的使用txt，就沒(méi)有一點(diǎn)格式了，用html雖然既有格式又能加入版本控制，但是需要花費(fèi)較多的時(shí)間在標(biāo)簽上，而且標(biāo)簽占了文檔的較大百分比，不易閱讀。

所以，最終的解決方案就是 **Markdown** ，作為一種輕量級(jí)的標(biāo)記語(yǔ)言，能在非常短的時(shí)間內(nèi)掌握。而且不僅可以用于寫文檔，還可以寫博客、寫簡(jiǎn)書、做一些隨手筆記。Markdown文件以.md結(jié)尾，可以導(dǎo)出為html和PDF（需要使用的工具支持）。它是一種語(yǔ)法（個(gè)人認(rèn)為是簡(jiǎn)化版的html），但是和html不同的是，各種解析器對(duì)其會(huì)有不同的表現(xiàn)。比如我的IDEA Markdown插件會(huì)把分割線顯示成一條細(xì)灰線，Cmd Markdown則是顯示一條虛線。所以建議保持使用一種Markdown工具和盡量使用標(biāo)準(zhǔn)語(yǔ)法。

二、Markdown基本語(yǔ)法

1. 標(biāo)題

代碼：

# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 最小只有六

效果：

一級(jí)標(biāo)題

二級(jí)標(biāo)題

三級(jí)標(biāo)題

四級(jí)標(biāo)題

五級(jí)標(biāo)題

最小只有六

2. 加粗

代碼：

**我要被加粗了**

效果：

我要被加粗了

3. 代碼引用（>式）

代碼：

> hello markdown!

效果：

hello markdown!

代碼：

> hello markdown!
>> hello markdown!

效果：

hello markdown!

hello markdown!

4.代碼引用（```式）

代碼：

效果：

hello markdown!

5.代碼引用（Tab式）

代碼：

    hello markdown!

效果：

hello markdown!

6. 插入鏈接（簡(jiǎn)單式）

代碼：

<http://example.com>

效果：

http://example.com

7.插入鏈接（內(nèi)嵌式）

代碼：

[搜狗](https://www.sogo.com "搜狗一下")

效果：

搜狗

8. 插入圖片

代碼：

![](https://upload-images.jianshu.io/upload_images/6912209-8c53b79a706bb7c2.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/273 '描述')

效果：

9. 有序列表

代碼：

1. one
2. two 
3. three

效果：

1. one
2. two
3. three

10. 無(wú)序列表

代碼：

* one
* two
* three

效果：

• one
• two
• three

11. 分割線

代碼：

---

效果：

---

12. 表格

代碼：

 name | age | sex 
:------:|:------|------:
tony|20|男
lucy|18|女

效果：

name	age	sex
tony	20	男
lucy	18	女

三、總結(jié)

以上所述就是Markdown的基本標(biāo)簽，雖然不多，但是可以解決大部分情況。

可以用20%的標(biāo)簽完成80%的效果

參考：