概述
認(rèn)識 Markdown
Markdown 是一種用來寫作的輕量級【標(biāo)記語言】,它通過使用一些符號組成的標(biāo)記來實(shí)現(xiàn)像 Word 那樣的排版。Markdown 的目的是實(shí)現(xiàn)【易讀易寫】砾嫉,無論如何纷铣, 可讀性设凹,是最重要的碱工。
Markdown 的優(yōu)點(diǎn)
- 讓我們專注于內(nèi)容沼琉,而不是排版樣式北苟。
- 純文本帶來的超強(qiáng)的兼容性, 所有文本編輯器都能打開打瘪。
- 格式轉(zhuǎn)換方便友鼻,能攻輕松地轉(zhuǎn)換為 pdf,html 等闺骚。
- 語法簡單彩扔,學(xué)習(xí)成本低。
Markdown 的誤區(qū)
We believe that writing is about content, about what you want to say – not about fancy formatting. 我們堅(jiān)信寫作寫得是內(nèi)容葛碧,所思所想,而不是花樣格式过吻。-Ulysses for Mac
語法
特殊符號
Markdown 是通過精挑細(xì)選的一些符號來實(shí)現(xiàn)內(nèi)容的排版的, 主要使用了:
\\ 反斜線 -- 用來轉(zhuǎn)義进泼,來實(shí)現(xiàn)符號插入
\` 反引號 -- Esc下方那個(gè)鍵,用于標(biāo)記代碼
\* 星號 -- 用于定義無序列表
_ 底線 -- 用來定義二級標(biāo)題
= 等號 -- 用來定義一級標(biāo)題
{} 花括號 --
[] 方括號 --
() 括弧 --
\# 井號 -- 用來定義標(biāo)題
\+ 加號 -- 用來定義無序列表
\- 減號 -- 用來定義無序列表
\. 英文句號 -- 通過和數(shù)字組合定義有序列表
\! 感嘆號 -- 用來區(qū)分引入的是網(wǎng)址還是圖片
\> 尖括號 --用來定義引用區(qū)塊
我們可以通過反斜杠來插入普通的符號纤虽,也可以通過反斜杠來插入一些語法中有其他意義的符號乳绕。例如用 * 號加在文字旁邊的方式來做出強(qiáng)調(diào)
區(qū)塊元素
標(biāo)題
這是最常用的格式,Markdown 支持兩種標(biāo)題的語法逼纸,類 Setext 和類 atx 形式洋措。 類 Setext 形式是用底線的形式, 利用 "=" (最高階標(biāo)題)和 "-"(第二階標(biāo)題)杰刽,例如:
This is H1
======
This is H1
===
This is H1
==
This is H2
--------
This is H2
---
This is H2
--
可以使用數(shù)量大于2個(gè)的 "=" 和 "-" 來實(shí)現(xiàn)一介標(biāo)題和二階標(biāo)題菠发。
類 Atx 形式則是在行首插入 1-6 個(gè) "#",對應(yīng)標(biāo)題 1-6 階贺嫂,例如
# This is H1
## This is H2
### This is H3
#### This is H4
##### This is H5
###### This is H6
你可以像這樣選擇性的閉合類 Atx 樣式的標(biāo)題滓鸠。
區(qū)塊引用
Markdown 標(biāo)記區(qū)塊引用用的是 ">" 來引用,例如這樣:
> 你的孤獨(dú)第喳,雖敗猶榮糜俗。也許你現(xiàn)在仍然是一個(gè)人下班,一個(gè)人乘地鐵曲饱,一個(gè)人上樓悠抹,一個(gè)人吃飯,一個(gè)人睡覺扩淀,一個(gè)人發(fā)呆楔敌。然而你卻能一個(gè)人下班,一個(gè)人乘地鐵驻谆,一個(gè)人上樓梁丘,一個(gè)人吃飯侵浸,一個(gè)人睡覺,一個(gè)人發(fā)呆氛谜。很多人離開另外一個(gè)人掏觉,就沒有自己。而你卻一個(gè)人值漫,度過了所有澳腹。
你也可以這樣:
> 你的孤獨(dú),雖敗猶榮杨何。 也許你現(xiàn)在仍然是一個(gè)人下班酱塔, 一個(gè)人乘地鐵,一個(gè)人上樓危虱,一個(gè)人吃飯羊娃,一個(gè)人睡覺,一個(gè)人發(fā)呆埃跷。
> 然而你卻能一個(gè)人下班蕊玷,一個(gè)人乘地鐵,一個(gè)人上樓弥雹,一個(gè)人吃飯垃帅,一個(gè)人睡覺,一個(gè)人發(fā)呆剪勿。
> 很多人離開另外一個(gè)人贸诚,就沒有自己。 而你卻一個(gè)人厕吉,度過了所有酱固。
你還可以這樣:
> 你的孤獨(dú),雖敗猶榮头朱。
>
> > 也許你現(xiàn)在仍然是一個(gè)人下班媒怯,一個(gè)人乘地鐵,一個(gè)人上樓髓窜,一個(gè)人吃飯扇苞,一個(gè)人睡覺,一個(gè)人發(fā)呆寄纵。
> >
> > 然而你卻能一個(gè)人下班鳖敷,一個(gè)人乘地鐵,一個(gè)人上樓程拭,一個(gè)人吃飯定踱,一個(gè)人睡覺,一個(gè)人發(fā)呆恃鞋。很多人離開另外一個(gè)人崖媚,就沒有自己亦歉。
>
> 而你卻一個(gè)人,度過了所有畅哑。
當(dāng)然肴楷,還能這樣:
> #### 你的孤獨(dú),雖敗猶榮荠呐。
>
> * 也許你現(xiàn)在仍然是一個(gè)人下班赛蔫,一個(gè)人乘地鐵,一個(gè)人上樓泥张,一個(gè)人吃飯呵恢,一個(gè)人睡覺,一個(gè)人發(fā)呆媚创。
>
> 1. 然而你卻能一個(gè)人下班渗钉,一個(gè)人乘地鐵,一個(gè)人上樓钞钙,一個(gè)人吃飯鳄橘,一個(gè)人睡覺,一個(gè)人發(fā)呆歇竟。很多人離開另外一個(gè)人挥唠,就沒有自己抵恋。
>
> + 而你卻一個(gè)人焕议,度過了所有。
列表
Markdown 支持有序列表和無序列表弧关。
無序列表通過 "*", "+", "-" 作為標(biāo)記符號盅安,例如:
* 1Red
* 1Green
* 1Blue
+ 2Red
+ 2Green
+ 2Blue
- 3Red
- 3Green
- 3Blud
有序列表則使用數(shù)字連接英文句號,例如:
1. 1Red
2. 1Green
3. 1Blue
211. 2Red
10. 2Green
54. 2Blue
很重要的一點(diǎn)是世囊,不論你在列表上使用的數(shù)字為幾都不影響 HTML 輸出别瞭。
代碼區(qū)塊
和程序相關(guān)的寫作,通常會有已經(jīng)排版好的代碼區(qū)塊株憾,我們不希望代碼也和文章一樣去排版蝙寨,而是希望它按照原來的樣子顯示,那么我們就希望用 Markdown 建立代碼區(qū)塊嗤瞎。
Markdown 建立代碼區(qū)塊很簡單墙歪,你可以簡單的縮進(jìn) 4 個(gè)空格或者 1 個(gè)制表符,例如:
這是一個(gè)普通段落
這是一個(gè)代碼段落 4 個(gè)空格
這是一個(gè)普通段落
這是一個(gè)代碼段落 1 個(gè)制表符
建立代碼區(qū)塊的 4 個(gè)方法中贝奇,4 個(gè)空格和一個(gè)制表符代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進(jìn)的那一行或者文件結(jié)尾虹菲。
分隔線
我們可以在一行中通過三個(gè)以上的 ''*', "-", "_" 來建立一個(gè)分隔線,行內(nèi)不能有除了空格以外的東西掉瞳,下面是三種不同的寫法建立的分隔線:
分隔線1
* * *
分隔線2
***
分隔線3
**********
分隔線4
- - -
分隔線5
---
分隔線6
----------
分隔線7
_ _ _
分隔線8
___
分隔線9
__________
分隔線要注意的是減號分隔線需要和上面一行間隔一行毕源,不然會把上面那行定義為二階標(biāo)題浪漠。
區(qū)段元素
鏈接
Markdown 支持兩種形式的鏈接語法:行內(nèi)式和參考式。通過 "[]" 方括號來標(biāo)記霎褐。行內(nèi)式鏈接只需要在方括號后面加入圓括號并插入網(wǎng)址即可址愿,如果還想加入鏈接的 title 文字,只需要在圓括號中在鏈接地址后加入一個(gè)空格再加入"" 把 title 文字包起來即可瘩欺,例如:
這是[百度](http://www.baidu.com "網(wǎng)絡(luò)1")必盖。
這是[本地資源](/1.html "本地1")。
參考式鏈接是在鏈接文字的方括號之后再接一個(gè)方括號俱饿,第二個(gè)方括號里面放的是鏈接的標(biāo)記歌粥,我們只要在文件中的任意位置把標(biāo)記定義出來就可以了,例如:
這是[百度][baidu]拍埠。
這是[本地資源][bendi]失驶。
[baidu]:http://www.baidu.com "網(wǎng)絡(luò)1"
[bendi]:/1.html (本地1)
我們可以看得出來,無論是標(biāo)記在何處定義枣购,標(biāo)記都是有效的嬉探,并且我們定義標(biāo)記的時(shí)候定義的 title 可以采取雙引號,圓括號 兩種形式棉圈。
**請注意: ** Markdown.p1 1.0.1 會忽略單引號包起來的鏈接 title涩堤,所以我介紹的時(shí)候沒有介紹單引號。
隱式鏈接標(biāo)記功能可以讓我們省去定義鏈接標(biāo)記分瘾,例如:
這是[Google][]
[Google]:http://www.google.com
圖片
Markdown 插入圖片采取的是和鏈接很相似的語法來標(biāo)記圖片的胎围,同樣也是允許兩種樣式:行內(nèi)式和參考式。都是在鏈接的前面添加一個(gè) "!" 標(biāo)識即可德召,存在 "!" 標(biāo)識的為圖片白魂,不存在的為鏈接,例如:
這是本地行內(nèi)圖片1 ![圖片1](/image/1.jpg "圖片1")
這是網(wǎng)絡(luò)行內(nèi)圖片2 ![圖片1](http://blog.qiji.tech/wp-content/uploads/2016/01/12-e1453187944177-64x64.jpg "圖片2")
[tupian3]: /image/1.jpg "圖片3"
這是本地參考圖片3 ![圖片3][tupian3]
這是網(wǎng)絡(luò)參考圖片4 ![圖片4][tupian4]
[tupian4]: http://blog.qiji.tech/wp-content/uploads/2016/01/12-e1453187944177-64x64.jpg "圖片4"
我們寫博文的時(shí)候經(jīng)常要用到圖片上岗;推薦:事先通過我們博客的多媒體把圖片上傳到我們博客福荸,到時(shí)候在文章中通過圖片標(biāo)簽把鏈接加上即可;也可以直接使用我們編輯博文的編輯器上方的 “Add Media” 來添加圖片肴掷。另外圖片的命名需要注意敬锐,最好是圖片所代表的意義,可為拼音可為英文呆瞻,別直接用QQ截圖xxxx的台夺。我們上傳的圖片生成的鏈接是有規(guī)律的,如果沒有命名重復(fù)的栋烤,一個(gè)批次上傳的鏈接只有文件名不同谒养,其他的都是一致的。
強(qiáng)調(diào)
Markdown 使用 "" 號和 "_" 來作為標(biāo)記強(qiáng)調(diào)字詞的符號,被一個(gè) "" 或者一個(gè) "" 包起來的字詞會變成斜體买窟,被兩個(gè) "*" 或者兩個(gè) "" 包起來的字詞會被加粗丰泊,例如:
*斜體*
_斜體_
**粗體**
__粗體__
代碼
如果要在行內(nèi)添加代碼,我們可以用\
把代碼包起來`始绍,例如:瞳购。
我要輸出代碼:`alert(ab);`。
我要輸出代碼:``alert(a`b);``亏推。
注意: 三個(gè) "```" 可以形成代碼區(qū)塊学赛,標(biāo)準(zhǔn)Markdown 是不支持的,GFM 才支持
注意:我們的博客暫時(shí)不支持行內(nèi)添加代碼標(biāo)簽的使用吞杭。
本地撰寫工具
Windows
- markdownpad2
- HarooPad
Mac
- Byword
- Mou
- MacDown
- Typora
Linux
- ReText
本文轉(zhuǎn)載自 Markdown 新手指南盏浇,如有冒犯,侵權(quán)芽狗,即刪绢掰。