轉(zhuǎn)自為知筆記的說(shuō)明書(shū)
2015-11-23產(chǎn)品與服務(wù)
Markdown 是什么
Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言，創(chuàng)始人為約翰·格魯伯（John Gruber）。它允許人們「使用易讀易寫(xiě)的純文本格式編寫(xiě)文檔，然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔 」—— 維基百科
如果你看不懂以上維基百科對(duì) Markdown 的定義，就當(dāng)這段掐了沒(méi)播。約翰·格魯伯自己對(duì)Markdown的描述的重點(diǎn)也在于 「easy-to-read，easy-to-write」。
那么到底 easy 在哪里呢？
雖然稱(chēng)作 「標(biāo)記語(yǔ)言」，但簡(jiǎn)單理解 Markdown 就是在文本前增加符號(hào)來(lái)表示文本格式。你不需要關(guān)心標(biāo)題多大號(hào)，列表縮進(jìn)多少，是否對(duì)齊，只要使用了同一種符號(hào)標(biāo)記，Markdown 已經(jīng)幫你做好了排版。
無(wú)圖無(wú)真相：
Markdown 的好處
編輯，不用操心排版你只需要把注意力放在內(nèi)容上。筆者在用 Markdown 之前，打開(kāi)word 先想想，標(biāo)題用啥字體呢，幾號(hào)字呢？不知不覺(jué)我的意志力就被消耗了。實(shí)際上所謂排版，不就是作者的思路以及內(nèi)容的層級(jí)和結(jié)構(gòu)么，在學(xué)會(huì)使用 Markdown 之后，幾個(gè)簡(jiǎn)單的符號(hào)就把這些事兒搞定，樣式還特別工整精美。
修改，不用擔(dān)心排版想想那些你在同事之間改來(lái)改去的 word 文檔吧，如果哪位童鞋從外部粘貼了一段帶格式的文字，那么你再次打開(kāi)文檔時(shí)會(huì)發(fā)現(xiàn)整個(gè)人都不好了：格式被改的亂七八糟，還要重新調(diào)整。如果用 Markdown 群組筆記 ，想改哪里改哪里，根本不用擔(dān)心格式，改完評(píng)論里直接 @TA，多輕松！
一句話(huà)來(lái)說(shuō)，Markdown 是用最簡(jiǎn)單的方式，零排版成本，寫(xiě)出布局工整、閱讀舒適的筆記。減少干擾，降低成本，提高效率，不管在什么設(shè)備上，看起來(lái)都是一個(gè)工整的樣子。不僅自己閱讀爽，分享給朋友也有面兒不是~
那些牛人都在用
陽(yáng)志平在 2012 年就發(fā)博客推崇了一下 Markdown，但那篇文章雖解讀深刻，但也略顯極客，把Markdown 不僅能排版，能做流程圖，還支持?jǐn)?shù)學(xué)公式的特性介紹了一遍，連科技論文都要選擇 Markdown 都涉獵到了。有興趣閱讀的童鞋可點(diǎn)擊這里查看。
很多在線(xiàn)博客和內(nèi)容社區(qū)都提供 Markdown 編輯器，不僅在閱讀上帶來(lái)了舒適、統(tǒng)一、美好的體驗(yàn)，每一個(gè)參與寫(xiě)作的人，也能夠毫不費(fèi)力地寫(xiě)出排版整齊的文章來(lái)。
如何在為知筆記上創(chuàng)建 Markdown 筆記
為知筆記所有客戶(hù)端都支持 Markdown ，有兩種方法可以創(chuàng)建 Markdown 筆記
第一種：在筆記標(biāo)題后面加 .md ，編輯并保存后，即可看到渲染后的效果
第二種：在移動(dòng)端直接創(chuàng)建 Markdown 筆記
編輯完成后，點(diǎn)擊 「保存」 按鈕，即可看到格式精美的筆記啦！
來(lái)個(gè)小技巧
不管我再怎么說(shuō) Markdown 的語(yǔ)法記憶負(fù)擔(dān)小、簡(jiǎn)單，在最初你都會(huì)有點(diǎn)兒暈。在這里給大家分享個(gè)小技巧：
最初只需要記住# 標(biāo)題一、## 標(biāo)題二、1. 第一點(diǎn)、* 這一點(diǎn)，用這幾個(gè)寫(xiě)寫(xiě)日志、需求文檔、小文章，排版上足夠了；
逐漸的你發(fā)現(xiàn)有些文字需要重點(diǎn)指出，那么還可以使用**加粗**、*斜體*來(lái)對(duì)文字做重點(diǎn)說(shuō)明；
如果你是名程序員，那么可以用```把代碼塊包起來(lái)，渲染后可以關(guān)鍵字高亮，用>可以做引用 ；
學(xué)生的話(huà)，就去了解一下 LaTex 吧，為知筆記 Markdown 支持 Mathjax 公式渲染哦~
Markdown 格式標(biāo)記符號(hào)說(shuō)明
1. 標(biāo)題
在行首插入 1 到 6個(gè)#，分別表示標(biāo)題 1 到標(biāo)題 6
# 這是標(biāo)題1
## 這是標(biāo)題1
###### 這是標(biāo)題6
點(diǎn)擊保存后的效果：
標(biāo)題1
標(biāo)題2
標(biāo)題6
2. 有序列表
在行首增加1.、2.、3.，即數(shù)字和英文句點(diǎn), 不要求數(shù)字一定要連續(xù)，可以都是1.
1. 有序列表
1. 有序列表
4. 有序列表
點(diǎn)擊保存后的效果：
有序列表
有序列表
有序列表
3. 無(wú)序列表
在行首增加*或-
* 無(wú)序列表
* 無(wú)序列表
點(diǎn)擊保存后的效果：
無(wú)序列表
無(wú)序列表
4. 插入圖片
可直接粘貼圖片，或?qū)D片文件拖動(dòng)到光標(biāo)處。
也可以使用標(biāo)準(zhǔn)的Markdown語(yǔ)法，如：
5. 插入鏈接
[描述](鏈接地址)，例如：[為知筆記](méi)(http://www.wiz.cn)，注意要使用英文符號(hào)
點(diǎn)擊保存后的效果：
6. 粗體、斜體、刪除線(xiàn)
粗體：在文字前后添加**(注意符號(hào)與文字間不要有空格）
斜體：在文字前后添加*
刪除線(xiàn)：在文字前后添加~~
**粗體**
*斜體*
~~刪除線(xiàn)~~
保存后的效果：
粗體
斜體
刪除線(xiàn)
7. 引用
在文字前 添加>
點(diǎn)擊保存后的效果：
如果你無(wú)法簡(jiǎn)潔的表達(dá)你的想法，那只說(shuō)明你還不夠了解它。 -- 阿爾伯特·愛(ài)因斯坦
8. 表格
|為知筆記|更新|版本|
|------------|-----------|--------|
|WizNote|Markdown|Latest|
點(diǎn)擊保存后的效果：
為知筆記更新版本
WizNoteMarkdownLatest
9. 代碼
在代碼前后增加 三個(gè)反單引號(hào)：```
```
int i = 0; i = 1;
for (int i = 0; i < 100; i++)
{
printf("hello markdown!\n");
}
```
保存后的效果：
如果需要指定語(yǔ)言， 在開(kāi)頭的``` 后緊跟具體語(yǔ)言，如: ```java
在任何你想要展示Markdown 筆記目錄的地方，添加[TOC]， 在閱讀模式下，標(biāo)題1~6樣式的內(nèi)容會(huì)被提取出來(lái)作為目錄，相當(dāng)于大綱功能。
例如：
[TOC]
###Markdown 是什么
####Markdown 的好處
點(diǎn)擊保存后的效果：
11. Mathjax 公式
可以創(chuàng)建行內(nèi)公式，例如：$\Gamma(n)=(n-1)!\quad\forall n\in\mathbb N$
或者塊級(jí)公式，
$$ x=\dfrac{-b \pm \sqrt{b^2-4ac}}{2a}$$
點(diǎn)擊保存后的效果：
12. 流程圖
```flow
st=>start: Start
e=>end: End
op1=>operation: My Operation
sub1=>subroutine: My Subroutine
cond=>condition: Yes or No?
io=>inputoutput: catch something...
st->op1->cond
cond(yes)->io->e
cond(no)->sub1(right)->op1
```
保存后效果：
注意：
1) 關(guān)鍵詞（start、end、operation、subroutine、condition和inputoutput）后的冒號(hào)后要緊跟一個(gè)空格。
2) 使用->來(lái)連接兩個(gè)元素，對(duì)于condition類(lèi)型，有yes和no兩個(gè)分支，如示例中的cond(yes)和cond(no)。
更多關(guān)于流程圖的語(yǔ)法說(shuō)明：http://adrai.github.io/flowchart.js/
13. 時(shí)序圖
```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am good thanks!
```
保存后效果：
更多關(guān)于時(shí)序圖的語(yǔ)法說(shuō)明：http://bramp.github.io/js-sequence-diagrams/
根據(jù)搜索歷史整理的相關(guān)關(guān)鍵詞：markdown ? mark down macdown?markdwon?markdowm makedown ?marknote?mardown?walkdown?workdown
