Markdown介紹及使用教程

Markdown是什么娜饵?

Markdown是一種「標(biāo)記語言」关划,通常為程序員群體所用小染。除此之外,Markdown也是國際雜志編輯以及許多寫作者都廣泛使用的標(biāo)記語言贮折。小源博客的所有文章也都是使用這一語言寫成的裤翩。

舉個(gè)例子解釋

大部分作家都是用 Word 或 Pages 寫作,過去的文檔也大都以微軟的 .doc, .docx 格式或是蘋果的 Pages 格式儲(chǔ)存调榄。還有人為了保證文稿發(fā)給誰都能正常打開踊赠,會(huì)用 .txt 格式。

但是.doc 或 Pages 格式有如下問題:

1.不一定誰都能打開每庆。用 Windows 的人打不開蘋果的 .pages 文件筐带,用舊版 Word 的人不一定能打開你用新版 Word 寫的稿子。

2.對(duì)方看到的稿子的樣子和你自己看到的可能差別很大扣孟。

3.大部分人電腦上的Office都是盜版的烫堤,使用時(shí)很容易出問題荣赶。

4.用.txt 寫的稿子沒有格式凤价,這就給編輯你文章的人帶來困擾了。

這就是 Markdown 登場(chǎng)的時(shí)候了拔创。

千萬不要被「標(biāo)記」利诺、「語言」嚇到,Markdown的語法十分簡(jiǎn)單剩燥,常用的標(biāo)記符號(hào)不超過十個(gè)慢逾,用于日常寫作記錄綽綽有余,不到半小時(shí)就能完全掌握灭红。

但就是這十個(gè)不到的標(biāo)記符號(hào)侣滩,卻能讓人優(yōu)雅地沉浸式記錄,專注內(nèi)容而不是糾結(jié)排版变擒,達(dá)到「心中無塵君珠,碼字入神」的境界。

Markdown 的優(yōu)點(diǎn)如下:

  • 純文本娇斑,所以兼容性極強(qiáng)策添,可以用所有文本編輯器打開。

兼顧了「什么人都能打開」和「樣式」毫缆。Markdown 就是純文本唯竹,就是 .txt,所以什么人都能打開苦丁。而如上所述浸颓,你可以用它來標(biāo)記文本的樣式,而且語法非常簡(jiǎn)單。
由于是純文本猾愿,Markdown 文稿也不會(huì)因?yàn)槲磥碥浖?jí)而產(chǎn)生不同版本之間的兼容問題鹦聪,即,不會(huì)出現(xiàn)「我這篇稿子是用舊版 Word 寫的蒂秘,你用新版 Word 看可能格式會(huì)有點(diǎn)問題」的情況泽本。

  • 讓你專注于文字而不是排版。

  • 格式轉(zhuǎn)換方便姻僧,Markdown 的文本你可以輕松轉(zhuǎn)換為 html规丽、電子書等。

Markdown 轉(zhuǎn) HTML 非常方便撇贺。HTML 是整個(gè)萬維網(wǎng)(web)的標(biāo)記語言赌莺,但更重要的是,它也是目前主流電子書格式所用的標(biāo)記語言松嘶。無論是 EPUB, mobi艘狭,還是 Kindle 用的專有格式 .azw,都只是把一堆 HTML 文件打包而已翠订。如果你寫的是書巢音,用 Markdown 標(biāo)注格式之后,可以很方便地轉(zhuǎn)為以上格式(當(dāng)然這個(gè)轉(zhuǎn)換工作不需要由你來做)尽超;如果你寫的是單篇的文章(例如新聞報(bào)道或?qū)冢┕俸常磥硪膊慌懦Y(jié)集出書的可能。若采用 Markdown似谁,對(duì)于日后的文件轉(zhuǎn)換工作也大有裨益傲绣。
如何開始用 Markdown?繼續(xù)用你習(xí)慣的寫作軟件即可巩踏。記事本秃诵、Word、Pages 都沒問題塞琼,但請(qǐng)記得存成純文本格式菠净。就這么簡(jiǎn)單。

  • Markdown 的標(biāo)記語法有極好的可讀性屈梁。

忘了說嗤练,Markdown沒有缺點(diǎn)

話不多說,現(xiàn)在開始學(xué)習(xí)吧在讶!

目錄

標(biāo)題

這是最為常用的格式构哺,在平時(shí)常用的的文本編輯器中大多是這樣實(shí)現(xiàn)的:輸入文本革答、選中文本战坤、設(shè)置標(biāo)題格式。

而在 Markdown 中残拐,你只需要在文本前面加上 # 即可途茫,同理、你還可以增加二級(jí)標(biāo)題溪食、三級(jí)標(biāo)題囊卜、四級(jí)標(biāo)題、五級(jí)標(biāo)題和六級(jí)標(biāo)題错沃,總共六級(jí)栅组,只需要增加 # 即可,標(biāo)題字號(hào)相應(yīng)降低枢析。例如:

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

注:# 和「一級(jí)標(biāo)題」之間建議保留一個(gè)字符的空格玉掸,這是最標(biāo)準(zhǔn)的 Markdown 寫法。

以下是在簡(jiǎn)書的示范截圖:

列表

列表格式也很常用醒叁,在 Markdown 中司浪,你只需要在文字前面加上 - 就可以了,例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表把沼,
也可以在文字前面加上 1. 2. 3. 就可以了啊易,例如:

1. 文本1
2. 文本2
3. 文本3

注:-1. 和文本之間要保留一個(gè)字符的空格智政。

以下是在簡(jiǎn)書的示范截圖:

在 Markdown 中认罩,插入鏈接不需要其他按鈕箱蝠,你只需要使用 [顯示文本](鏈接地址) 這樣的語法即可续捂,例如:

[何嘉源的博客](https://hejiayuan1998.github.io/)
[何嘉源工作室](https://www.hjyweb.com)

在 Markdown 中,插入圖片不需要其他按鈕宦搬,你只需要使用 [圖片上傳失敗...(image-cbe5a9-1527687698857)] 這樣的語法即可牙瓢,例如:

![](http://upload-images.jianshu.io/upload_images/1811713-ccc7102e810d1400.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注:插入圖片的語法和鏈接的語法很像,只是前面多了一個(gè) ! 间校。

插入鏈接和圖片的案例截圖:

引用

在我們寫作的時(shí)候經(jīng)常需要引用他人的文字矾克,這個(gè)時(shí)候引用這個(gè)格式就很有必要了,在 Markdown 中憔足,你只需要在你希望引用的文字前面加上 > 就好了胁附,例如:

>歡迎關(guān)注“何嘉源的博客”
>始于顏值、陷于才華滓彰、忠于人品

注:> 和文本之間要保留一個(gè)字符的空格控妻。

最終顯示的就是:

歡迎關(guān)注“何嘉源的博客”

始于顏值、陷于才華揭绑、忠于人品

引用的案例截圖:

粗體和斜體

Markdown 的粗體和斜體也非常簡(jiǎn)單弓候,用兩個(gè) * 包含一段文本就是粗體的語法郎哭,用一個(gè) * 包含一段文本就是斜體的語法。例如:

*何嘉源的博客*
**始于顏值菇存、陷于才華夸研、忠于人品**

最終顯示的就是下文,其中「小源博客」是斜體依鸥,「始于顏值亥至、陷于才華、忠于人品」是粗體:

何嘉源的博客

始于顏值贱迟、陷于才華抬闯、忠于人品

粗體和斜體的案例截圖:

代辦清單To-do List

你可以在Markdown中編寫代辦清單

相關(guān)代碼

- [x] 已完成項(xiàng)目1
  - [x] 已完成事項(xiàng)
  - [ ] 代辦事項(xiàng)
- [ ] 代辦項(xiàng)目2
- [ ] 代辦項(xiàng)目3

顯示效果:

  • [x] 已完成項(xiàng)目1
    • [x] 已完成事項(xiàng)
    • [ ] 代辦事項(xiàng)
  • [ ] 代辦項(xiàng)目2
  • [ ] 代辦項(xiàng)目3

代辦清單To-do List的案例截圖

表格

使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行:

為了美觀关筒,可以使用空格對(duì)齊不同行的單元格溶握,并在左右兩側(cè)都使用 | 來標(biāo)記單元格邊界:

在表頭下方的分隔線標(biāo)記中加入 :,即可標(biāo)記下方單元格內(nèi)容的對(duì)齊方式:

  • :--- 代表左對(duì)齊
  • :--: 代表居中對(duì)齊
  • ---: 代表右對(duì)齊

相關(guān)代碼:

| 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

相關(guān)代碼:

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz
dog bird cat
foo foo foo
bar bar bar
baz baz baz

表格的案例截圖

高效繪制 流程圖蒸播、序列圖睡榆、甘特圖

流程圖

相關(guān)代碼:

graph TD
    A[Christmas] -->B(Go Shopping)
    B --> C{Let me think}
    C -->|one| D[Laptop]
    C -->|two| E[iPhone]
    C -->|three| F[Car]

流程圖案例截圖

序列圖

相關(guān)代碼:

sequenceDiagram
    loop every day
        Alice->John: Hello John, how are you?
        John->Alice: Great!
    end

序列圖案例截圖

甘特圖

相關(guān)代碼:

gantt
dateFormat YYYY-MM-DD
title 產(chǎn)品計(jì)劃表
section 初期階段
明確需求: 2016-03-01, 10d
section 中期階段
跟進(jìn)開發(fā): 2016-03-11, 15d
section 后期階段
走查測(cè)試: 2016-03-20, 9d

甘特圖案例截圖

書寫數(shù)學(xué)公式

相關(guān)代碼:

$y = x^2$

inline math: `$\dfrac{
\tfrac{1}{2}[1-(\tfrac{1}{2})^n] }{
1-\tfrac{1}{2} } = s_n$`.

數(shù)學(xué)公式案例截圖:

代碼引用

需要引用代碼時(shí),如果引用的語句只有一段袍榆,不分行胀屿,可以將語句包起來。
如果引用的語句為多行包雀,可以將```置于這段代碼的首行和末行宿崭。如果要建立一個(gè)已經(jīng)格式化好的程式碼區(qū)塊,只要每行都縮排 4 個(gè)空格或是一個(gè) tab 就可以了才写。

代碼引用的案例截圖:

編輯器與擴(kuò)展

這部分給大家介紹一些可以用來書寫葡兑、編輯 Markdown 的工具,包括獨(dú)立客戶端赞草、編輯器/IDE 插件讹堤,以及基于 Web 的工具等,排名不分先后厨疙。

  • MarkdownPad (Windows)
  • Texts Windows (OSX)
  • MarkPad (Windows)
  • MdCharm (Windows Linux)
  • Markdown Edit (Windows)
  • CuteMarkEd (Windows Linux)
  • Haroopad (Windows OSX Linux)
  • Mou (OSX)
  • MacDown (OSX)
  • Markdown Pro (OSX)
  • ReText (Linux)
  • sublime-markdown-extended (Sublime Text)
  • Atom Markdown Preview (Atom)
  • IDEA Markdown (IDEA)
  • Cmd Markdown (Windows OSX Linux Web)
  • StackEdit (Web)
  • Dillinger (Web)

MarkdownPad

主頁: MarkdownPad
平臺(tái): Windows (XP+)
費(fèi)用: 免費(fèi)版洲守、Pro 版 ($14.95) 技術(shù): Microsoft .NET

介紹

MarkdownPad 是一款 Windows 平臺(tái)上的 Markdown 編輯器,提供了多文件編輯沾凄、實(shí)時(shí)預(yù)覽梗醇、自定義樣式、文件導(dǎo)出等功能撒蟀。提供了免費(fèi)版本和包含高級(jí)功能的 Pro 付費(fèi)版叙谨,支持多國語言。

格式轉(zhuǎn)換

Markdown 文檔可以方便地轉(zhuǎn)換為 HTML牙肝、Word唉俗、PDF 等格式的文檔嗤朴。這些轉(zhuǎn)換既可以通過你正在使用的 Markdown 編輯器完成,也可以通過一些命令行工具(如 Pandoc虫溜、Gitbook)來完成雹姊,甚至可以用你熟悉的語言編程實(shí)現(xiàn)。

這個(gè)部分主要介紹通過編輯器或命令行工具來實(shí)現(xiàn) Markdown 文檔到下列格式的轉(zhuǎn)換:

  • HTML
  • PDF
  • Word

轉(zhuǎn)換為 HTML 文檔

MdCharm

選擇 ‘File’, ‘Export to…’衡楞,勾選 ‘HTML’, 點(diǎn)擊 ‘Browser…’ 選擇導(dǎo)出目錄并輸入導(dǎo)出的文件名吱雏,點(diǎn)擊 ‘OK’,即可將當(dāng)前的 Markdown 文檔轉(zhuǎn)換為 HTML 文檔瘾境。

如果不滿意 HTML 文檔的樣式歧杏,可以在設(shè)置中自定義 CSS。

Pandoc

參考 Installing 安裝 Pandoc迷守。

打開命令行犬绒,進(jìn)入文檔所在目錄:

cd /path/to/file/

執(zhí)行下面的命令,將 Markdown 轉(zhuǎn)換為 HTML:

pandoc -o hello.html hello.md

默認(rèn)的轉(zhuǎn)換兑凿,只是將 Markdown 內(nèi)容轉(zhuǎn)換為 HTML 標(biāo)簽凯力,所以只能看到瀏覽器的默認(rèn)樣式。

可以執(zhí)行下面的命令礼华,為導(dǎo)出的 HTML 添加自定義樣式:

pandoc -o hello.html -c style.css hello.md

style.css 仍然是以 <link> 的方式關(guān)聯(lián)到 HTML 文檔中的咐鹤,所以在發(fā)布的時(shí)候需要將 CSS 一同發(fā)布出去。

轉(zhuǎn)換為 PDF 文檔

MdCharm

與導(dǎo)出 HTML 文檔類似圣絮,選擇 ‘File’, ‘Export to…’祈惶,勾選 ‘PDF’, 點(diǎn)擊 ‘Browser…’ 選擇導(dǎo)出目錄并輸入導(dǎo)出的文件名,點(diǎn)擊 ‘OK’扮匠,即可將當(dāng)前的 Markdown 文檔轉(zhuǎn)換為 PDF 文檔捧请。

如果不滿意 PDF 文檔的樣式,可以在設(shè)置中自定義 CSS餐禁。

Pandoc

使用 Pandoc 導(dǎo)出 PDF 文檔血久,需要先安裝某個(gè) LaTeX 引擎(參考 Creating a PDF)突照。然后執(zhí)行命令:

pandoc -o hello.pdf hello.md

當(dāng)然帮非,也可以通過 -c style.css 來指定樣式文件。

Chrome

在將 Markdown 轉(zhuǎn)換為 HTML 文檔 之后讹蘑,可以通過 Chrome 瀏覽器 打開它末盔。選擇 ‘打印’(Ctrl+P),然后更改 ‘目標(biāo)打印機(jī)’ 為 ‘另存為 PDF’座慰,再進(jìn)行一些設(shè)置后陨舱,即可保存為 PDF 文檔。

轉(zhuǎn)換為 Word 文檔

復(fù)制粘貼

在導(dǎo)出為 HTML 文檔之后版仔,可以(在瀏覽器中)手動(dòng)復(fù)制 HTML 頁面的內(nèi)容游盲,然后粘貼到 Word 文檔中误墓,保存即可。

Pandoc

執(zhí)行下面的命令益缎,即可將 Markdown 文檔轉(zhuǎn)換為 Word 文檔:

pandoc -o hello.docx hello.md

后記

除了以上幾種格式是比較常用的格式之外谜慌,Markdown 還有其他語法,如想了解和學(xué)習(xí)更多莺奔,可以參考這篇『Markdown 語法說明』欣范。

參考資料

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市令哟,隨后出現(xiàn)的幾起案子恼琼,更是在濱河造成了極大的恐慌,老刑警劉巖屏富,帶你破解...
    沈念sama閱讀 206,839評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件晴竞,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡狠半,警方通過查閱死者的電腦和手機(jī)颓鲜,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,543評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來典予,“玉大人甜滨,你說我怎么就攤上這事×鲂洌” “怎么了衣摩?”我有些...
    開封第一講書人閱讀 153,116評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)捂敌。 經(jīng)常有香客問我艾扮,道長(zhǎng),這世上最難降的妖魔是什么占婉? 我笑而不...
    開封第一講書人閱讀 55,371評(píng)論 1 279
  • 正文 為了忘掉前任泡嘴,我火速辦了婚禮,結(jié)果婚禮上逆济,老公的妹妹穿的比我還像新娘酌予。我一直安慰自己,他們只是感情好奖慌,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,384評(píng)論 5 374
  • 文/花漫 我一把揭開白布抛虫。 她就那樣靜靜地躺著,像睡著了一般简僧。 火紅的嫁衣襯著肌膚如雪建椰。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,111評(píng)論 1 285
  • 那天岛马,我揣著相機(jī)與錄音棉姐,去河邊找鬼屠列。 笑死,一個(gè)胖子當(dāng)著我的面吹牛伞矩,可吹牛的內(nèi)容都是我干的脸哀。 我是一名探鬼主播,決...
    沈念sama閱讀 38,416評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼扭吁,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼撞蜂!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起侥袜,我...
    開封第一講書人閱讀 37,053評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤蝌诡,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后枫吧,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體浦旱,經(jīng)...
    沈念sama閱讀 43,558評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,007評(píng)論 2 325
  • 正文 我和宋清朗相戀三年九杂,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了颁湖。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,117評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡例隆,死狀恐怖甥捺,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情镀层,我是刑警寧澤镰禾,帶...
    沈念sama閱讀 33,756評(píng)論 4 324
  • 正文 年R本政府宣布,位于F島的核電站唱逢,受9級(jí)特大地震影響吴侦,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜坞古,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,324評(píng)論 3 307
  • 文/蒙蒙 一备韧、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧痪枫,春花似錦织堂、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,315評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至尿瞭,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間翅睛,已是汗流浹背声搁。 一陣腳步聲響...
    開封第一講書人閱讀 31,539評(píng)論 1 262
  • 我被黑心中介騙來泰國打工黑竞, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人疏旨。 一個(gè)月前我還...
    沈念sama閱讀 45,578評(píng)論 2 355
  • 正文 我出身青樓很魂,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國和親檐涝。 傳聞我的和親對(duì)象是個(gè)殘疾皇子遏匆,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,877評(píng)論 2 345