mammoth2008 (25)在 #markdown · 2年前 (edited)
寫在前面的說明^_^:
這是我去年在簡書發(fā)表的文章;
搬運過來主要目的是嘗試一下Steemit的CMS;
要是能給Markdown學習者們提供一點點幫助就更好啦;
好了,以下是正文~
“人生有很多坑,完全可以單腳一躍而過;可是大多數(shù)人,卻偏偏要繞個大圈子?!?/p>
“對未知事物的恐懼,幾乎是本能的反應吧?”
——《Markdown 操作用戶反饋》,沐沐周
不要恐慌,不要恐慌,不要恐慌。
為什么要學習和使用 Markdown?如果你想要流暢表達想法,不想在鍵盤和鼠標之間頻繁切換而中斷思路;如果你想讓你的文稿可以在任何地方打開;想讓你的文稿一次排版,到處可用;想讓排版更快;需要和其他人一起協(xié)同寫作或翻譯——那么你應該試試看 Markdown。
本文的目標讀者,是習慣以 Microsoft Office、Pages、WPS 或 LibraOffice 為寫作編輯軟件,較少或從未使用過 Markdown 的計算機用戶。
本文假設(shè)讀者擁有一定計算機使用能力,足以完成網(wǎng)絡(luò)搜索、瀏覽、文檔寫作與編輯等任務。
本文將會嘗試解釋一些概念。這些解釋可能會幫助讀者更容易地理解,但未必精準。
互聯(lián)網(wǎng)上已經(jīng)有大量 Markdown 相關(guān)資料,本文將會在“6 擴展閱讀”部分給出一些擴展閱讀材料。
做是最好的學。我們需要一個可以快速上手的Markdown 編輯器,它應該可以實時預覽。建議現(xiàn)在點擊作業(yè)部落,并且在閱讀本文時隨時嘗試。
Markdown 是一種輕量級標記語言。它是一種標準、一種語言,而非特定的軟件;所以我們一般說“Markdown 編輯器”,而不說“Markdown 軟件”。所有文本編輯器都能編輯 Markdown,挑自己喜歡順手的就好。
“輕量級”:是指結(jié)構(gòu)簡單,容易記憶也容易上手。
“標記語言”:是指它會通過一些特定符號來實現(xiàn)特定功能;而這些符號會直接寫在文字當中。我們將會在“4 Markdown 語法”部分詳細描述這些符號。
Markdown 語言的設(shè)計目標是讓人們“使用易讀易寫的純文本格式編寫文檔,并且可以轉(zhuǎn)換成其他格式?!?/p>
“純文本格式”:是指可以用最簡單的文檔編輯器打開的格式,例如 Windows 上的“記事本”、Mac 上的“TextEdit”,或一些 Linux 發(fā)行版上的“gedit”。
一般來說,純文本格式文件的擴展名是“.txt”,這是最通用的文檔文件格式,所有文本編輯器都能打開。
Markdown 文檔的擴展名是“.md”或“.markdown”,一般建議使用“.md”。
“轉(zhuǎn)換成其他格式”:Markdown 格式可以輕松地轉(zhuǎn)化成日常使用的大部分文檔格式,包括但不限于.doc .html .pdf 等。
Markdown 最重要的設(shè)計是可讀性。撰寫 Markdown 不是為了讓機器更容易讀取,而是為了讓人能夠輕松閱讀。
Markdown 已經(jīng)獲得了許多網(wǎng)站的支持,并且成為了 Github、Reddit 等著名社區(qū)的標準。
在這一部分,將從以下幾個方面,對比 Markdown 和 Microsoft Word 。
通用程度:
Markdown 的 .md 格式:所有的文本編輯器都可以編輯。在“3 支持 Markdown 的編輯器”中列出了常見工具。
Word 的 .doc 或 .docx 格式:只有 Microsoft Word、 LibraOffice、WPS 等幾種軟件能夠編輯。
學習難度:
Markdown:幾分鐘就可以學會常用語法。
Word:“大部分人只用到了 Word 不到 5% 的功能。”看看書店里的教程數(shù)量和厚度就知道。
可讀性:
Markdown 文檔:可讀性強,文本中的符號基本不會影響閱讀。
Word 文檔:如果你有 Word 的話,還不錯;若是你沒有,強行打開 Word 文檔就只能看到一堆亂碼。
轉(zhuǎn)換成其他格式:
Markdown:可以很容易地轉(zhuǎn)換成多種格式的文檔,當然也包括 .doc 或 .docx。
Word :除了“另存為”對話框中提供的格式之外,只能尋找其他工具來幫助轉(zhuǎn)換。
管理不同版本:
Markdown:可以使用通行的版本管理工具管理不同版本,可以避免編輯時多份不同版本內(nèi)容沖突或丟失。
Word:通常的做法,是在 Word 文檔文件名后面加上一串數(shù)字,來手工管理版本。
協(xié)作:
Markdown:可以使用 Github 等協(xié)同工具,多人同時或不同時編輯。
Word:一份文檔傳來傳去,同一時間只能由一個人修改。
最重要的區(qū)別在于, Word 本質(zhì)上是一個排版軟件而非寫作支持軟件,大量按鈕和菜單讓人們很難專注于寫作本身。
而 Markdown 是種純粹而優(yōu)美的寫作工具,只是兼顧排版而已。
推薦 Sublime Text 3,強大優(yōu)雅的編輯器。
MarkdownPad,一款可以直接預覽排版效果的編輯器。
推薦 Ulysess,專注寫作的編輯器,功能強大,體驗一流。
Macdown,可以預覽排版效果。
ReText,也可以預覽。
推薦簡書,有 Markdown 寫作/預覽模式。
作業(yè)部落,功能強大的 Markdown 編輯器。
在 Firefox 瀏覽器上,推薦插件 It’s All Text!,可以將網(wǎng)頁上的文本框轉(zhuǎn)化為 Markdown 編輯器。
在和 Evernote 配合使用時,推薦使用馬克飛象。
歡迎補充,隨時更新。
現(xiàn)在可以在作業(yè)部落的左側(cè)窗口中試試看了。無需注冊,直接開始輸入文字就好。
首先需要注意:在 Markdown 中另起一段時,需要多敲一次回車鍵,來在段落之間添加一個空行。這是與其他常見文檔格式的不同之處。
這是因為,在一些 Markdown 解釋器中,會把相鄰的兩行合并成同一個段落。
例如,當我們這樣書寫時:
這是第一段。
這是第二段。
實際上看到的效果是這樣:
這是第一段。這是第二段。
雖然并非所有 Markdown 解釋器都會用同樣的解釋方式,但是為了避免出錯,還是多敲一次回車來添加一個空行吧。
Markdown 中,只需要在文本前面加上“#”,就會被認為是加了一個標題。同理,你還可以增加二級、三級、四級、五級標題和六級標題,只需要增加“#” 即可。例如:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
當你要羅列一些內(nèi)容時,列表是很有用的工具。為了說明哪些條目屬于這個列表,我們需要引入“項目標記”。
列表項目標記通常放在段落開頭,后面要跟著一個空格。列表的各個條目之間可以不留空行。
若列表中的條目沒有特定順序時,可以使用 無序列表。加號“+”或減號“-”都可以作為列表標記,后面要跟一個空格。例如:
- Red
- Green
- Blue
或者
+ Red
+ Green
+ Blue
實際顯示的效果都是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
Red
Green
Blue
若想在段落前加上數(shù)字序號,就需要用到有序列表了。使用數(shù)字、一個英文句號和一個空格即可。例如:
1. Red
2. Green
3. Blue
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
Red
Green
Blue
Markdown 中可以插入圖片,只需要感嘆號、方括號和圓括號即可。例如:
![Alt text](/path/to/img.jpg)
一個英文感嘆號 “!” 后緊跟方括號,里面可以寫這張圖片的說明;再緊跟一對圓括號,里面寫這張圖片的網(wǎng)址。例如:
![吃面條](http://這里是下圖的圖片網(wǎng)址)
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
有些 Markdown 編輯器也支持拖拽插入圖片,這就簡單多了。例如簡書 或者 Ulysses 就有這種功能。
在文檔中插入連接的語法和插入圖片的語法很像,只是少了最前面的英文感嘆號"!"。
在方括號寫下鏈接文字,圓括號寫下網(wǎng)址即可。例如:
[好中文的樣子](http://www.jianshu.com/p/d409bb2b5d6c)
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
可以使用">" 標記來引用其他人的言論、書籍或報紙的內(nèi)容。只需要在段落的第一行最前面加上 > 即可:
> ”每位作者都應該學習 Markdown?!?——王佩
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
”每位作者都應該學習 Markdown?!?——王佩
引用可以嵌套,只要根據(jù)層次的不同,加上不同數(shù)量的 > 即可:
> 這是第一級引用。
>> 這是第二級引用。
> 現(xiàn)在回到第一級引用。
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
這是第一級引用。
這是第二級引用。
現(xiàn)在回到第一級引用。
在引用的區(qū)域內(nèi),也可以使用其他的 Markdown 語法,包括標題、列表等:
> ## 這是一個標題。
> 1. 這是第一行列表項。
> 2. 這是第二行列表項。
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
這是一個標題。
這是第一行列表項。
這是第二行列表項。
在Markdown中,可以使用 * 和 _ 來表示斜體和加粗。需要注意的是,“_”是下劃線而非減號“-”。
在需要斜體的文本左右各加一個“*”或“_” :
*吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。*
_吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。_
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。
吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。
在需要加粗的文本左右各加兩個“*”或“_” :
**吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。**
__吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。__
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。
吹吹那熱風,聽聽那冷雨,看哪,好中文的樣子。
在 Markdown 中,可以用分隔線來將內(nèi)容分成不同區(qū)域。
只需要連續(xù)三個減號"-"即可。例如:
---
實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):
Q: 我該去哪里下載 Markdown 軟件?
A: Markdown 是一種標準而非軟件,任何支持 Markdown 語法的編輯器都可以使用,無論是何種操作系統(tǒng)、哪類設(shè)備。請看“3 支持 Markdown 的編輯器”,或者問問 Google。
Q:在簡書里怎么切換 Markdown?為什么切換了沒有反應?
A:建議使用 Chrome 或 Firefox 瀏覽器。在簡書中,點擊右上角個人頭像-設(shè)置,在“常用編輯器”中選中markdown,然后保存。注意一行小字:“切換后對新建文章生效”。然后點擊右上角”寫新文章“,再點擊工具欄右側(cè)倒數(shù)第三個按鈕“切換到預覽模式”,屏幕應該會分成左右兩個區(qū)域。在左側(cè)區(qū)域輸入內(nèi)容、添加標記,右側(cè)就會實時顯示 Markdown 效果了。
Q: 為什么我按說明寫了標記,但是沒法正常顯示?
A: 很可能是你誤把中文標點當成了英文標點。在 Markdown 中使用標點符號作為標記時,要使用英文標點符號。沒關(guān)系,人們總會犯這種小錯誤。
Q: 為什么我寫了正確的標記,但是在編輯窗口中看不到任何效果?
A: 許多 Markdown 編輯器都不是所見即所得的——“所見即所得”是指你對格式的修改會馬上反映在屏幕上,就像 Word 那樣。如果你的編輯器沒有沒有實時預覽功能,就不會看到格式的變化。Macdown和簡書 都支持實時預覽,你需要先打開這個功能,才能看到這些格式標記的效果。
Q: Markdown 可以排版表格嗎?
A: 可以,如果你熟練的話,排版表格也會很快。表格的語法請見“Markdown 語法說明(簡體中文版)”。
Q: Markdown可以排版數(shù)學公式嗎?
A: 可以。只要有相應的擴展,Markdown 可以支持LaTeX 公式、甚至畫流程圖和甘特圖。
Q: 標題效果和加粗有區(qū)別嗎?
A: 看似沒有,其實還是有的。這涉及到如何解釋 Markdown 標記的問題,一般和 CSS 有關(guān)。更多信息,請看“6 擴展閱讀”部分。
Q: 加圖片時,無 IT 背景人士一般會采用從桌面拖拽的方式。Markdown 支持拖拽嗎?
A: 拖拽圖片插入文檔或上傳到網(wǎng)站,不是 Markdown 語法本身的內(nèi)容。不過有些網(wǎng)站和 Markdown 編輯器支持拖拽方式,例如 Ulysess 和 簡書 。
Q: Markdown 正文可以調(diào)整字號嗎?
A: 同樣和解釋 Markdown 標記的方式有關(guān)。更多信息,請看“6 擴展閱讀”部分。
Q: Markdown 段落開頭不能空兩格,看著很難受啊。有辦法解決嗎?
A: 辦法嘛……若是在自己機器上的 Markdown 編輯器中,也許你可以修改 CSS。若是在 簡書 之類網(wǎng)站上,可能只能手工在每段開始前手工添加五個“&n bsp;”了。記得,是“&nb sp;”,字符和字母之間都沒有空格。最后的分號也是有必要的哦~
更多關(guān)于 Markdown 語法或工具的內(nèi)容,可以參考:
Markdown 是定義文章邏輯結(jié)構(gòu),而非定義樣式的。一般來說,Markdown 最終呈現(xiàn)出的樣式,是由對應的層疊樣式表(CSS)所定義的。如果想要自己調(diào)整出想要的樣式,可以從 CSS 開始。這里有一份 CSS 教程:《CSS 入門教程》
不斷擴充中,歡迎補充。
本文是《好中文的樣子》課程 G056組小組協(xié)作作業(yè)的衍生作品。
計劃共有三篇。截止20170219:
Markdown 新手手冊(本文)
Git 新手手冊(撰寫中)
GitHub 新手手冊(未開始)
更多內(nèi)容,請關(guān)注專題《GC4WPS03E05-番外》
撰寫:葉猛犸
其他貢獻者:Zoom.Quiet,粒粒如一, 迷妹喬小喵,瑪雅藍
聯(lián)系客服