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)題
- 引用
- 粗體和斜體
- 代辦清單To-do List
- 表格
- 高效繪制 流程圖煞抬、序列圖、甘特圖
- 書寫數(shù)學(xué)公式
- 代碼引用
- 編輯器與擴(kuò)展
- 格式轉(zhuǎn)換
- 后記
- 參考資料
- 協(xié)議/License
標(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
- 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 語法說明』欣范。