Markdown 新手指南

概述

認(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
--
Setext 格式的標(biāo)題

可以使用數(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)題

你可以像這樣選擇性的閉合類 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ū)塊

建立代碼區(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")。
行內(nèi)式鏈接

參考式鏈接是在鏈接文字的方括號之后再接一個(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);``亏推。

行內(nèi)代碼

注意: 三個(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)芽狗,即刪绢掰。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市童擎,隨后出現(xiàn)的幾起案子滴劲,更是在濱河造成了極大的恐慌,老刑警劉巖顾复,帶你破解...
    沈念sama閱讀 212,718評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件班挖,死亡現(xiàn)場離奇詭異,居然都是意外死亡芯砸,警方通過查閱死者的電腦和手機(jī)萧芙,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,683評論 3 385
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來乙嘀,“玉大人末购,你說我怎么就攤上這事破喻』⑿唬” “怎么了?”我有些...
    開封第一講書人閱讀 158,207評論 0 348
  • 文/不壞的土叔 我叫張陵曹质,是天一觀的道長婴噩。 經(jīng)常有香客問我,道長羽德,這世上最難降的妖魔是什么几莽? 我笑而不...
    開封第一講書人閱讀 56,755評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮宅静,結(jié)果婚禮上章蚣,老公的妹妹穿的比我還像新娘。我一直安慰自己姨夹,他們只是感情好纤垂,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,862評論 6 386
  • 文/花漫 我一把揭開白布矾策。 她就那樣靜靜地躺著,像睡著了一般峭沦。 火紅的嫁衣襯著肌膚如雪贾虽。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 50,050評論 1 291
  • 那天吼鱼,我揣著相機(jī)與錄音蓬豁,去河邊找鬼。 笑死菇肃,一個(gè)胖子當(dāng)著我的面吹牛地粪,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播琐谤,決...
    沈念sama閱讀 39,136評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼驶忌,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了笑跛?” 一聲冷哼從身側(cè)響起付魔,我...
    開封第一講書人閱讀 37,882評論 0 268
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎飞蹂,沒想到半個(gè)月后几苍,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,330評論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡陈哑,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,651評論 2 327
  • 正文 我和宋清朗相戀三年妻坝,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片惊窖。...
    茶點(diǎn)故事閱讀 38,789評論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡刽宪,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出界酒,到底是詐尸還是另有隱情圣拄,我是刑警寧澤,帶...
    沈念sama閱讀 34,477評論 4 333
  • 正文 年R本政府宣布毁欣,位于F島的核電站庇谆,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏凭疮。R本人自食惡果不足惜饭耳,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 40,135評論 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望执解。 院中可真熱鬧寞肖,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,864評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至栅葡,卻和暖如春茉兰,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背欣簇。 一陣腳步聲響...
    開封第一講書人閱讀 32,099評論 1 267
  • 我被黑心中介騙來泰國打工规脸, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人熊咽。 一個(gè)月前我還...
    沈念sama閱讀 46,598評論 2 362
  • 正文 我出身青樓莫鸭,卻偏偏與公主長得像,于是被迫代替她去往敵國和親横殴。 傳聞我的和親對象是個(gè)殘疾皇子被因,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,697評論 2 351

推薦閱讀更多精彩內(nèi)容