Markdown 是一種輕量級標(biāo)記語言,它允許人們使用易讀易寫的純文本格式編寫文檔,在2004由約翰·格魯伯(英語:JohnGruber)創(chuàng)建。通過簡單的標(biāo)記語法,它可以使普通文本內(nèi)容具有一定的格式。
優(yōu)點:
- 操作簡單(語法簡單,幾分鐘就能學(xué)會)
- Markdown 被廣泛使用來撰寫電子書,如:Gitbook。
- 被用來來撰寫幫助文檔或是用于論壇上發(fā)表消息。例如:GitHub、簡書、reddit等。
正是Markdown的快速高效,我選擇了它(我使用的文本編輯器是sublime)
注:本文轉(zhuǎn)載自:http://www.lxweimin.com/p/191d1e21f7ed/ ,正是通過此文我學(xué)會Markdown基本語法,為練手特意仿原作者的博客自己做一遍,內(nèi)容上加了轉(zhuǎn)義字符和自己遇到的一些問題。
一、標(biāo)題
在想要設(shè)置為標(biāo)題的文字前面加#來表示
一個#是一級標(biāo)題,二個#是二級標(biāo)題,以此類推。支持六級標(biāo)題。
注:標(biāo)準(zhǔn)語法一般在#后跟個空格再寫文字
示例:
## 示例二級標(biāo)題
### 這是三級標(biāo)題
#### 這是四級標(biāo)題
##### 這是五級標(biāo)題
###### 這是六級標(biāo)題
效果如下:
示例二級標(biāo)題
這是三級標(biāo)題
這是四級標(biāo)題
這是五級標(biāo)題
這是六級標(biāo)題
二、字體
-
加粗
要加粗的文字左右分別用兩個*號包起來 -
斜體
要傾斜的文字左右分別用一個*號包起來 -
斜體加粗
要傾斜和加粗的文字左右分別用三個*號包起來 -
刪除線
要加刪除線的文字左右分別用兩個~~號包起來
示例:
**這是加粗的文字**
*這是傾斜的文字*
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
效果如下:
這是加粗的文字
這是傾斜的文字
這是斜體加粗的文字
這是加刪除線的文字
三、引用
在引用的文字前加>即可。引用也可以嵌套,如加兩個>>三個>>>
n個...
貌似可以一直加下去,但沒什么用
示例:
>這是引用的內(nèi)容
>>這是引用的內(nèi)容
>>>>>>>>>>這是引用的內(nèi)容
效果如下:
這是引用的內(nèi)容
這是引用的內(nèi)容
這是引用的內(nèi)容
四、分割線
三個或者三個以上的-或*都可以
示例:
---
----
***
*****
效果如下:
可以看到,顯示效果都是一樣的,不過不知道為何"---"需要換行才能顯示4行,不然只有3行
五、圖片
語法:

圖片alt就是顯示在圖片下面的文字,相當(dāng)于對圖片內(nèi)容的解釋。
圖片title是圖片的標(biāo)題,當(dāng)鼠標(biāo)移到圖片上時顯示的內(nèi)容。title可加可不加
示例:

效果如下:
markdown格式追求的是簡單、多平臺統(tǒng)一。那么圖片的存儲就是一個問題,需要用圖床,提供統(tǒng)一的外鏈,這樣就不用在不同的平臺去處理圖片的問題了。才能做到書寫一次,各處使用。
關(guān)于圖床的選擇原作者寫了一篇文章,對網(wǎng)上存在的各種方法做了總結(jié),需要的朋友可以看看。markdown圖床
六、超鏈接
語法:
[超鏈接名](超鏈接地址 "超鏈接title")
title可加可不加
示例:
[GitHub](https://github.com/)
[百度](http://baidu.com)
效果如下:
注:Markdown本身語法不支持鏈接在新頁面中打開,貌似簡書做了處理,是可以的。別的平臺可能就不行了,如果想要在新頁面中打開的話可以用html語言的a標(biāo)簽代替。
<a href="超鏈接地址" target="_blank">超鏈接名</a>
示例
<a href="http://www.lxweimin.com/u/1f5ac0cf6a8b" target="_blank">簡書</a>
七、列表
無序列表
語法:
無序列表用 - + * 任何一種都可以
- 列表內(nèi)容
+ 列表內(nèi)容
* 列表內(nèi)容
注意:- + * 跟內(nèi)容之間都要有一個空格
效果如下:
- 列表內(nèi)容
- 列表內(nèi)容
- 列表內(nèi)容
有序列表
語法:
數(shù)字加點
1. 列表內(nèi)容
2. 列表內(nèi)容
3. 列表內(nèi)容
注意:序號跟內(nèi)容之間要有空格
效果如下:
- 列表內(nèi)容
- 列表內(nèi)容
- 列表內(nèi)容
列表嵌套
上一級和下一級之間敲三個空格即可
-
一級無序列表內(nèi)容
- 二級無序列表內(nèi)容
- 二級無序列表內(nèi)容
- 二級無序列表內(nèi)容
-
一級無序列表內(nèi)容
- 二級有序列表內(nèi)容
- 二級有序列表內(nèi)容
- 二級有序列表內(nèi)容
-
一級有序列表內(nèi)容
- 二級無序列表內(nèi)容
- 二級無序列表內(nèi)容
- 二級無序列表內(nèi)容
-
一級有序列表內(nèi)容
- 二級有序列表內(nèi)容
- 二級有序列表內(nèi)容
- 二級有序列表內(nèi)容
注:無序列表下似乎只能無序?
八、表格
語法:
表頭|表頭|表頭
---|:--:|---:
內(nèi)容|內(nèi)容|內(nèi)容
內(nèi)容|內(nèi)容|內(nèi)容
第二行分割表頭和內(nèi)容。
- 有一個就行,為了對齊,多加了幾個
文字默認(rèn)居左
-兩邊加:表示文字居中
-右邊加:表示文字居右
注:原生的語法兩邊都要用 | 包起來。此處省略
示例:
| 左對齊 | 右對齊 | 居中 |
| :-------- | -------:| :--: |
| Computer | 5000 元 | 1臺 |
| Phone | 1999 元 | 1部 |
//hexo下有時會出問題
效果如下:
左對齊 | 右對齊 | 居中 |
---|---|---|
Computer | 5000 元 | 1臺 |
Phone | 1999 元 | 1部 |
九、代碼
語法:
單行代碼:代碼之間分別用一個反引號包起來
`代碼內(nèi)容`
代碼塊:代碼之間分別用三個反引號包起來,且兩邊的反引號單獨占一行
(```)
代碼...
代碼...
代碼...
(```)
注:為了防止轉(zhuǎn)譯,前后三個反引號處加了小括號,實際是沒有的。這里只是用來演示,實際中去掉兩邊小括號即可。
示例:
單行代碼
`create database hero;`
代碼塊
(```)
function fun(){
echo "這是一句非常牛逼的代碼";
}
fun();
(```)
效果如下:
單行代碼
create database hero;
代碼塊
function fun(){
echo "這是一句非常牛逼的代碼";
}
fun();
十、流程圖
···flow #由于渲染問題,請自行將 · 替換為 `
st=>start: 開始語句
in=>inputoutput: 輸入值
e=>end: 結(jié)束語句
op=>operation: 執(zhí)行操作
cond=>condition: 是否成立?
out=>inputoutput: 輸出值
st->in->op->cond
cond(yes)->out
cond(no)->op
out->e
···
效果如下:
注:hexo不能直接使用流程圖,要先引入:npm install --save hexo-filter-flowchart
hexo優(yōu)化:Markdown語法引入Flowchart和Mermaid流程圖
十一、轉(zhuǎn)義字符
在使用 markdown 編輯器編寫文檔的時候,有時候需要輸入一些特殊符號,然而卻是 markdown 的語法,那就需要使用轉(zhuǎn)義字符。只需要再特殊符號前加上反斜杠 \ 即可
示例:
\\
\*
\_
\{\}
\[\]
\(\)
\#
\+
\-
\.
\!