Markdown是一種「標(biāo)記語(yǔ)言」,通常為程序員群體所用。除此之外,Markdown也是國(guó)際雜志編輯以及許多寫(xiě)作者都廣泛使用的標(biāo)記語(yǔ)言。小源博客的所有文章也都是使用這一語(yǔ)言寫(xiě)成的。
大部分作家都是用 Word 或 Pages 寫(xiě)作,過(guò)去的文檔也大都以微軟的 .doc, .docx 格式或是蘋(píng)果的 Pages 格式儲(chǔ)存。還有人為了保證文稿發(fā)給誰(shuí)都能正常打開(kāi),會(huì)用 .txt 格式。
但是.doc 或 Pages 格式有如下問(wèn)題:
1.不一定誰(shuí)都能打開(kāi)。用 Windows 的人打不開(kāi)蘋(píng)果的 .pages 文件,用舊版 Word 的人不一定能打開(kāi)你用新版 Word 寫(xiě)的稿子。
2.對(duì)方看到的稿子的樣子和你自己看到的可能差別很大。
3.大部分人電腦上的Office都是盜版的,使用時(shí)很容易出問(wèn)題。
4.用.txt 寫(xiě)的稿子沒(méi)有格式,這就給編輯你文章的人帶來(lái)困擾了。
千萬(wàn)不要被「標(biāo)記」、「語(yǔ)言」嚇到,Markdown的語(yǔ)法十分簡(jiǎn)單,常用的標(biāo)記符號(hào)不超過(guò)十個(gè),用于日常寫(xiě)作記錄綽綽有余,不到半小時(shí)就能完全掌握。
但就是這十個(gè)不到的標(biāo)記符號(hào),卻能讓人優(yōu)雅地沉浸式記錄,專注內(nèi)容而不是糾結(jié)排版,達(dá)到「心中無(wú)塵,碼字入神」的境界。
兼顧了「什么人都能打開(kāi)」和「樣式」。Markdown 就是純文本,就是 .txt,所以什么人都能打開(kāi)。而如上所述,你可以用它來(lái)標(biāo)記文本的樣式,而且語(yǔ)法非常簡(jiǎn)單。
由于是純文本,Markdown 文稿也不會(huì)因?yàn)槲磥?lái)軟件升級(jí)而產(chǎn)生不同版本之間的兼容問(wèn)題,即,不會(huì)出現(xiàn)「我這篇稿子是用舊版 Word 寫(xiě)的,你用新版 Word 看可能格式會(huì)有點(diǎn)問(wèn)題」的情況。
讓你專注于文字而不是排版。
格式轉(zhuǎn)換方便,Markdown 的文本你可以輕松轉(zhuǎn)換為 html、電子書(shū)等。
Markdown 轉(zhuǎn) HTML 非常方便。HTML 是整個(gè)萬(wàn)維網(wǎng)(web)的標(biāo)記語(yǔ)言,但更重要的是,它也是目前主流電子書(shū)格式所用的標(biāo)記語(yǔ)言。無(wú)論是 EPUB, mobi,還是 Kindle 用的專有格式 .azw,都只是把一堆 HTML 文件打包而已。如果你寫(xiě)的是書(shū),用 Markdown 標(biāo)注格式之后,可以很方便地轉(zhuǎn)為以上格式(當(dāng)然這個(gè)轉(zhuǎn)換工作不需要由你來(lái)做);如果你寫(xiě)的是單篇的文章(例如新聞報(bào)道或?qū)冢?,未?lái)也不排除結(jié)集出書(shū)的可能。若采用 Markdown,對(duì)于日后的文件轉(zhuǎn)換工作也大有裨益。
如何開(kāi)始用 Markdown?繼續(xù)用你習(xí)慣的寫(xiě)作軟件即可。記事本、Word、Pages 都沒(méi)問(wèn)題,但請(qǐng)記得存成純文本格式。就這么簡(jiǎn)單。
這是最為常用的格式,在平時(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 寫(xiě)法。
以下是在簡(jiǎn)書(shū)的示范截圖:
列表格式也很常用,在 Markdown 中,你只需要在文字前面加上 -
就可以了,例如:
- 文本1- 文本2- 文本3
如果你希望有序列表,
也可以在文字前面加上 1.
2.
3.
就可以了,例如:
1. 文本12. 文本23. 文本3
注:-
、1.
和文本之間要保留一個(gè)字符的空格。
以下是在簡(jiǎn)書(shū)的示范截圖:
在 Markdown 中,插入鏈接不需要其他按鈕,你只需要使用 [顯示文本](鏈接地址)
這樣的語(yǔ)法即可,例如:
[何嘉源的博客](https://hejiayuan1998.github.io/)[何嘉源工作室](https://www.hjyweb.com)
在 Markdown 中,插入圖片不需要其他按鈕,你只需要使用 [圖片上傳失敗...(image-cbe5a9-1527687698857)]
這樣的語(yǔ)法即可,例如:

注:插入圖片的語(yǔ)法和鏈接的語(yǔ)法很像,只是前面多了一個(gè) !
。
插入鏈接和圖片的案例截圖:
在我們寫(xiě)作的時(shí)候經(jīng)常需要引用他人的文字,這個(gè)時(shí)候引用這個(gè)格式就很有必要了,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了,例如:
>歡迎關(guān)注“何嘉源的博客”>始于顏值、陷于才華、忠于人品
注:>
和文本之間要保留一個(gè)字符的空格。
最終顯示的就是:
歡迎關(guān)注“何嘉源的博客”
始于顏值、陷于才華、忠于人品
引用的案例截圖:
Markdown 的粗體和斜體也非常簡(jiǎn)單,用兩個(gè) *
包含一段文本就是粗體的語(yǔ)法,用一個(gè) *
包含一段文本就是斜體的語(yǔ)法。例如:
*何嘉源的博客***始于顏值、陷于才華、忠于人品**
最終顯示的就是下文,其中「小源博客」是斜體,「始于顏值、陷于才華、忠于人品」是粗體:
何嘉源的博客
始于顏值、陷于才華、忠于人品
粗體和斜體的案例截圖:
你可以在Markdown中編寫(xiě)代辦清單
相關(guān)代碼
- [x] 已完成項(xiàng)目1 - [x] 已完成事項(xiàng) - [ ] 代辦事項(xiàng)- [ ] 代辦項(xiàng)目2- [ ] 代辦項(xiàng)目3
顯示效果:
代辦清單To-do List的案例截圖
使用 |
來(lái)分隔不同的單元格,使用 -
來(lái)分隔表頭和其他行:
為了美觀,可以使用空格對(duì)齊不同行的單元格,并在左右兩側(cè)都使用 |
來(lái)標(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 | foobar | bar | barbaz | 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)代碼:
ganttdateFormat YYYY-MM-DDtitle 產(chǎn)品計(jì)劃表section 初期階段明確需求: 2016-03-01, 10dsection 中期階段跟進(jìn)開(kāi)發(fā): 2016-03-11, 15dsection 后期階段走查測(cè)試: 2016-03-20, 9d
甘特圖案例截圖
相關(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í),如果引用的語(yǔ)句只有一段,不分行,可以將語(yǔ)句包起來(lái)。
如果引用的語(yǔ)句為多行,可以將```置于這段代碼的首行和末行。如果要建立一個(gè)已經(jīng)格式化好的程式碼區(qū)塊,只要每行都縮排 4 個(gè)空格或是一個(gè) tab 就可以了。
代碼引用的案例截圖:
這部分給大家介紹一些可以用來(lái)書(shū)寫(xiě)、編輯 Markdown 的工具,包括獨(dú)立客戶端、編輯器/IDE 插件,以及基于 Web 的工具等,排名不分先后。
主頁(yè): 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)版,支持多國(guó)語(yǔ)言。
Markdown 文檔可以方便地轉(zhuǎn)換為 HTML、Word、PDF 等格式的文檔。這些轉(zhuǎn)換既可以通過(guò)你正在使用的 Markdown 編輯器完成,也可以通過(guò)一些命令行工具(如 Pandoc、Gitbook)來(lái)完成,甚至可以用你熟悉的語(yǔ)言編程實(shí)現(xiàn)。
這個(gè)部分主要介紹通過(guò)編輯器或命令行工具來(lái)實(shí)現(xiàn) Markdown 文檔到下列格式的轉(zhuǎn)換:
選擇 ‘File’, ‘Export to…’,勾選 ‘HTML’, 點(diǎn)擊 ‘Browser…’ 選擇導(dǎo)出目錄并輸入導(dǎo)出的文件名,點(diǎn)擊 ‘OK’,即可將當(dāng)前的 Markdown 文檔轉(zhuǎn)換為 HTML 文檔。
如果不滿意 HTML 文檔的樣式,可以在設(shè)置中自定義 CSS。
參考 Installing 安裝 Pandoc。
打開(kāi)命令行,進(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
仍然是以的方式關(guān)聯(lián)到 HTML 文檔中的,所以在發(fā)布的時(shí)候需要將 CSS 一同發(fā)布出去。
與導(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 導(dǎo)出 PDF 文檔,需要先安裝某個(gè) LaTeX 引擎(參考 Creating a PDF)。然后執(zhí)行命令:
pandoc -o hello.pdf hello.md
當(dāng)然,也可以通過(guò) -c style.css
來(lái)指定樣式文件。
在將 Markdown 轉(zhuǎn)換為 HTML 文檔
之后,可以通過(guò) Chrome 瀏覽器 打開(kāi)它。選擇 ‘打印’(Ctrl P),然后更改 ‘目標(biāo)打印機(jī)’ 為 ‘另存為 PDF’,再進(jìn)行一些設(shè)置后,即可保存為 PDF 文檔。
復(fù)制粘貼
在導(dǎo)出為 HTML 文檔之后,可以(在瀏覽器中)手動(dòng)復(fù)制 HTML 頁(yè)面的內(nèi)容,然后粘貼到 Word 文檔中,保存即可。
執(zhí)行下面的命令,即可將 Markdown 文檔轉(zhuǎn)換為 Word 文檔:
pandoc -o hello.docx hello.md
除了以上幾種格式是比較常用的格式之外,Markdown 還有其他語(yǔ)法,如想了解和學(xué)習(xí)更多,可以參考這篇『Markdown 語(yǔ)法說(shuō)明』。
聯(lián)系客服