獻給寫作者的 Markdown 新手指南

為什么作家應該用 Markdown 保存自己的文稿

Markdown寫作淺談

Markdown 語法說明

Markdown 公式指導手冊

什么是極客最愛的Markdown？

Markdown是一種輕量級的「標記語言」，通常為程序員群體所用，目前它已是全球最大的技術分享網(wǎng)站 GitHub 和技術問答網(wǎng)站 StackOverFlow 的御用書寫格式

Markdown是一種可以使用普通文本編輯器編寫的標記語言，通過類似HTML的標記語法，它可以使普通文本內(nèi)容具豐富多彩的格式

Markdown的語法十分簡單，常用的標記符號不超過十個，用于日常寫作記錄綽綽有余，不到半小時就能完全掌握。

就是這十個不到的標記符號，卻能讓人優(yōu)雅地沉浸式記錄，專注內(nèi)容而不是糾結排版，達到「心中無塵，碼字入神」的境界

• Markdown和擴展Markdown簡潔的語法
• 代碼塊高亮
• 圖片鏈接和圖片上傳
• LaTex數(shù)學公式
• UML序列圖和流程圖
• 離線寫博客
• 導入導出Markdown文件
• 豐富的快捷鍵

利用Markdown可以做什么？

代碼高亮

制作待辦事項To-do List

高效繪制 流程圖、序列圖、甘特圖、表格

流程圖：

序列圖

甘特圖：

表格：

書寫數(shù)學公式

Markdown使用指南

標題

標題是每篇文章必備而且最常用的格式。

在Markdown中，如果想將一段文字定義為標題，只需要在這段文字前面加上 #，再在 # 后加一個空格即可。還可增加二、三、四、五、六級標題，總共六級，只需要增加 # ，增加一個 # ，標題字號相應降低一級。如圖：

列表

列表格式也很常用，它可以讓你的文稿變得井井有條。在 Markdown 中，你只需要在文字前面加上 - 就可以了；如果你希望是有序列表，在文字前面加上 1. 2. 3. 即可。

注：-、1.和文字之間要保留一個字符的空格。

引用

如果你需要在文稿中引用一段別處的句子，那么就要用到「引用」格式。

在引用文字前加上 > 并與文字保留一個字符的空格，即可。

粗體和斜體

Markdown 的粗體和斜體也非常簡單：

用兩個 * 包含一段文本就是粗體的語法；

用一個 * 包含一段文本就是斜體的語法。

鏈接與圖片

鏈接：在 Markdown 中，插入鏈接只需要使用[顯示文本](鏈接地址) 即可。

圖片：在 Markdown 中，插入圖片只需要使用 即可。

注：插入圖片的語法和鏈接的語法很像，只是前面多了一個 ！

分割線

分割線的語法只需要另起一行，連續(xù)輸入三個星號 * 即可分割兩段文字內(nèi)容。

如圖：

表格

當你需要在Markdown文稿中鍵入表格，代碼如下：

示例參考：

如上7大格式是寫作文稿時最常使用的。

怎么樣，看了相關Markdown語法是不是覺得挺簡單？

當然，Markdown新手在使用不熟練的情況下，可能會忘記相關語法，也沒關系，筆記的工具欄內(nèi)置了Markdown語法，方便學習與熟悉。

如，「表格」語法相對復雜，你可能忘記了，這時候，你只需要點擊編輯框上方工具欄，點選「表格」的圖標，左邊編輯區(qū)便會出現(xiàn)「表格」相應代碼：

然后，你只需要將代碼替換成相應文本即可，如圖：

熟悉語法之后，還是建議大家少使用輔助工具欄，盡量自己鍵入代碼，感受純文本之美。

當然，有道云筆記的Markdown還能支持制作待辦事項，書寫流程圖、序列圖、甘特圖，書寫數(shù)學公式等，是不是夠極客，夠有逼格？

看看筆記菌用Markdown甘特圖寫的項目計劃時間表：

待辦和清單

待辦事項和清單在日常工作、生活中經(jīng)常被使用。

在Markdown中，你只需要在待辦的事項文本或者清單文本前加上- [ ]、- [x]即可。

- [ ] 表示未完成，- [x] 表示已完成。

注：鍵入字符與字符之間都要保留一個字符的空格。

具體呈現(xiàn)如下：

流程圖

在Markdown中，一段流程圖語法以 “開頭，以 “ 結尾。

在 “` 后另起一行，書寫graph XX，用以確定將要繪制的流程圖及其類型（XX表示流程圖類型）。

流程圖分為豎向和橫向兩大類，豎向包括自上而下和自下而上兩種順序，橫向包括從右到左和從左到右兩種順序。

其對應語法分別為：graph TB/graph BT/graph RL/graph LR。

TB - top bottom（自上而下）
BT - bottom top（自下而上）
RL - right left（從右到左）
LR - left right（從左到右）

簡單示例如圖：

來學習一個具體案例：

仔細研究上述案例，會發(fā)現(xiàn)，我們可以通過調(diào)整語法來調(diào)整流程圖的框線、連接線，不同條件能導向不同結果。

對框線形狀的調(diào)整，如

對箭頭的調(diào)整，如

只要充分掌握該語法，再復雜的流程圖也完全能用Markdown書寫！

更詳細的流程圖語法，可參見：http://knsv.github.io/mermaid/#flowcharts-basic-syntax

甘特圖

我們在工作中用甘特圖作計劃進度表、項目進度表再合適不過了。

以如下甘特圖為例說明

與流程圖一樣，Markdown中，甘特圖的語法也是以 “開頭，以 “ 結尾。

在 “` 后另起一行，書寫 gantt ，用以確定將要繪制的是甘特圖。

標題的書寫語法如下：

dateFormat YYYY-MM-DD規(guī)定了時間軸，title （標題文本）表示甘特圖標題。

如需按項目進行劃分，需鍵入section，空一個字符，再輸入項目名稱的文本（一個section和另一個section之間要空行）。

每個大項目將拆解為若干個小任務，只需在section之后另起一行，直接輸入小項目名稱即可。

更詳細的甘特圖語法，參見：http://knsv.github.io/mermaid/#styling39

Tips for 有道云筆記中的 Markdown

實時同步預覽，所看即所得

我們將筆記編輯界面一分為二，左邊為編輯區(qū)，右邊為預覽區(qū)，兩區(qū)滾動條同步。在編輯區(qū)的操作能夠實時反映在預覽區(qū)，方便及時調(diào)整和查看最終版面效果。

工具欄內(nèi)置Markdown語法，方便新手學習

編輯頁面頂端的工具欄有對應代碼，如果你是一個不熟悉Markdown語法的新手，可以先嘗試用工具欄輔助操作。也可以在網(wǎng)上搜索「Markdown語法指南」進行學習。

當然，如果你覺得工具欄太打擾，點擊下方分界條即可隱藏工具欄，切換到極簡編輯環(huán)境。

實時云端保存

Markdown模式繼承了有道云筆記的優(yōu)良傳統(tǒng)，你每一次擊鍵的內(nèi)容都會實時保存在云端，無需擔心瀏覽器崩潰、設備沒電、突然斷網(wǎng)等情況。對于寫作者來說，更是再也不用擔心因為各種原因痛失文稿的情況了。

界面大小可點擊分界條調(diào)整。

點擊“1”處，工具欄收起；

點擊“2”處，右側預覽區(qū)收起。

點擊后效果如圖

http://note.youdao.com/iyoudao/?p=2411

快捷鍵

• 加粗 Ctrl + B
• 斜體 Ctrl + I
• 引用 Ctrl + Q
• 插入鏈接 Ctrl + L
• 插入代碼 Ctrl + K
• 插入圖片 Ctrl + G
• 提升標題 Ctrl + H
• 有序列表 Ctrl + O
• 無序列表 Ctrl + U
• 橫線 Ctrl + R
• 撤銷 Ctrl + Z
• 重做 Ctrl + Y

Markdown及擴展

Markdown 是一種輕量級標記語言，它允許人們使用易讀易寫的純文本格式編寫文檔，然后轉換成格式豐富的HTML頁面。 —— [ 維基百科 ]

使用簡單的符號標識不同的標題，將某些文字標記為粗體或者斜體，創(chuàng)建一個鏈接等，詳細語法參考幫助？。

本編輯器支持 Markdown Extra , 　擴展了很多好用的功能。具體請參考[Github]

表格

Markdown　Extra　表格語法：

項目價格

Computer	$1600
Phone	$12
Pipe	$1

可以使用冒號來定義對齊方式：

項目價格數(shù)量

Computer	1600 元	5
Phone	12 元	12
Pipe	1 元	234

定義列表

Markdown　Extra　定義列表語法：項目１項目２

定義 A

定義 B

項目３

定義 C

定義 D

定義D內(nèi)容

代碼塊

代碼塊語法遵循標準markdown代碼，例如：

@requires_authorization def somefunc(param1='', param2=0):'''A docstring'''if param1 > param2: # interestingprint 'Greater'return (param2 - param1 + 1) or None class SomeClass:pass >>> message = '''interpreter ... prompt'''

腳注

生成一個腳注[^footnote]
[^footnote]: 這里是 腳注 的 內(nèi)容

目錄

用 [TOC]來生成目錄

數(shù)學公式

使用MathJax渲染LaTex 數(shù)學公式，詳見[math.stackexchange.com]

• 行內(nèi)公式，數(shù)學公式為：Γ(n)=(n?1)!?n∈N。
• 塊級公式：

x=?b±b2?4ac???????√2a

更多LaTex語法請參考 [這兒]

UML 圖:

可以渲染序列圖：

Created with Rapha?l 2.1.0張三張三李四李四嘿，小四兒, 寫博客了沒?李四愣了一下，說：忙得吐血，哪有時間寫。

或者流程圖：

Created with Rapha?l 2.1.0開始我的操作確認？結束yesno

• 關于 序列圖 語法，參考 [這兒]
• 關于 流程圖 語法，參考 [這兒]

離線寫博客

即使用戶在沒有網(wǎng)絡的情況下，也可以通過本編輯器離線寫博客（直接在曾經(jīng)使用過的瀏覽器中輸入write.blog.csdn.net/mdeditor即可。Markdown編輯器使用瀏覽器離線存儲將內(nèi)容保存在本地

用戶寫博客的過程中，內(nèi)容實時保存在瀏覽器緩存中，在用戶關閉瀏覽器或者其它異常情況下，內(nèi)容不會丟失。用戶再次打開瀏覽器時，會顯示上次用戶正在編輯的沒有發(fā)表的內(nèi)容

博客發(fā)表后，本地緩存將被刪除

用戶可以選擇 把正在寫的博客保存到服務器草稿箱，即使換瀏覽器或者清除緩存，內(nèi)容也不會丟失

注意：雖然瀏覽器存儲大部分時候都比較可靠，但為了您的數(shù)據(jù)安全，在聯(lián)網(wǎng)后，請務必及時發(fā)表或者保存到服務器草稿箱

讓 Markdown 寫作更簡單，免費極簡編輯器：Typora

數(shù)學公式對應的markdown代碼

平方差公式
a2?b2=(a+b)(a?b)

立方差公式
a3?b3=(a+b)(a2?ab+b2)

立方和公式
a3+b3=(a?b)(a2+ab+b2)

完全平方公式
(a+b)2=a2+2ab+b2
(a?b)2=a2?2ab+b2

一元二次方程求根公式
ax2+bx+c=0
x1,2=?b±b2?4ac√2a

韋達定理
　　設x1,x2是一元二次方程ax2+bx+c=0的兩個根，則x1,x2滿足:
x1+x2=?ba
x1?x2=ca

有關集合的公式
　　設I為全集，?為空集，如果A是I的子集,B是I的子集，則A?I, B?I。
于是，
I∪A=I
I∩?=?
若Aˉ={x|x∈I且x?A,A?I},
　Bˉ={x|x∈I且x?B,B?I}
則
A∪Aˉ=I
A∩Aˉ=?
A∩Bˉˉˉˉˉˉˉˉˉ=Aˉ∪Bˉ
A∪Bˉˉˉˉˉˉˉˉˉ=Aˉ∩Bˉ

不等式
8.1) |a|≥0
8.2) |a|?|b|≤|a+b|≤|a|+|b|
8.3) |a|≤b
8.5) |a|≤b??b≤a≤b　(b>0)
8.6) a2+b2>2ab　(a,b∈R)
8.7) a+b2≥ab??√　(a,b∈R+)
8.7) ba+ab≥2　(ab>0)
8.7) a+b+c3≥abc???√3　(a,b,c∈R)
8.7) a1+a2+…+ann≥a1a2…an????????√n　a1,a2,…,an∈R+n∈N且n>1

排列組合
9.1) Amn=n!(n?m)!
9.2) Cmn=n!m!(n?m)!
9.3) Cmn=C(nn?m)
9.4) Cmn+1=Cmn+Cm?1n
9.5) C0n+C1n+…+Cnn=2n

積分公式
10.1) ∫sin(x)dx=cos(x)+C
10.2) ∫cos(x)dx=?sin(x)+C
10.3) ∫tan(x)dx=?ln|cos(x)|+C
10.4) ∫cot(s)dx=ln|sin(x)|+C
10.5) ∫sec2(x)dx=tan(x)+C

導數(shù)公式
11.1) (C)′=0
11.2) (sinx)′=cosx
11.3) (tanx)′=sec2x
11.4) (secx)′=secxtanx
11.5) (ax)′=axlnx
11.6) (xμ)=μxμ?1
11.7) (cosx)′=?sinx
11.8) (cotx)′=?csc2x
11.9) (cscx)′=?cscxcotx
11.10) (ex)′=ex
11.11) (logax)′=1xlna
11.12) (lnx)′=1x
11.13) (arcsinx)′=11?x2?????√
11.14) (arccosx)′=?11?x2?????√
11.15) (arctanx)′=11+x2
11.16) (arccotx)′=?11+x2

重要的極限
12.1) limx→0sinxx=1
12.2) limx→∞(1+1x)x=e

1. 平方差公式 $ a^2-b^2= (a+b)(a-b) $ 2. 立方差公式 $ a^3-b^3 = (a+b)(a^2-ab+b^2) $ 3. 立方和公式 $ a^3+b^3 = (a-b)(a^2+ab+b^2)$ 4. 完全平方公式 $(a + b)^2 = a^2 + 2ab+b^2 $ $(a - b)^2 = a^2 - 2ab+b^2 $ 5. 一元二次方程求根公式 $ ax^2+bx+c =0$ $x_{1,2}=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$ 6. 韋達定理設$x1,x2$是一元二次方程$ ax^2+bx+c =0$的兩個根，則$x1,x2$滿足: <center>$x1+x2 = -\frac{b}{a}$ $ x1 \cdot x2 = \frac{c}{a}$</center> 7. 有關集合的公式設$I$為全集，$\varnothing$為空集，如果$A$是$I$的子集,$B$是$I$的子集，則$A \subset I $, $ B \subset I $。 于是， <center>$I \cup A = I$ $I \cap \varnothing = \varnothing$</center> 若$ \bar A =\{x|x \in I且x \notin A,A \subseteq I \}$, $ \bar B =\{x|x \in I且x \notin B,B \subseteq I \}$ 則 <center>$ A \cup \bar A = I$ $ A \cap \bar A = \varnothing$ $\overline {A \cap B} = \bar A \cup \bar B$ $\overline {A \cup B} = \bar A \cap \bar B$ </center> 8. 不等式 8.1) $|a| \ge 0$ 8.2) $|a|-|b| \le |a+b| \le |a|+|b|$ 8.3) $|a| \le b $ 8.5) $|a| \le b \Leftrightarrow -b \le a \le b　 (b>0)$ 8.6) $a^2+b^2 \gt 2ab　(a,b \in R)$ 8.7) $\frac{a+b}{2} \ge \sqrt{ab}　(a,b \in R^+)$ 8.7) $\frac{b}{a} + \frac{a}{b} \ge 2　(ab>0)$ 8.7) $\frac{a+b+c}{3} \ge \sqrt[3]{abc}　(a,b,c \in R)$ 8.7) $\frac{a_1+a_2+ \ldots +a_n}{n} \ge \sqrt[n]{a_1a_2\ldots a_n}　a_1,a_2, \ldots,a_n \in R^+ n \in N且n>1$ 9. 排列組合 9.1) $ A_n^m = \frac{n!}{(n-m)!} $ 9.2) $ C_n^m = \frac{n!}{m!(n-m)!} $ 9.3) $ C_n^m = C_n^(n-m)$ 9.4) $ C_{n+1}^m = C_n^m + C_n^{m-1}$ 9.5) $C_n^0+C_n^1+\ldots +C_n^n = 2^n$10. 積分公式 10.1) $\int sin(x)dx = cos(x) +C$ 10.2) $\int cos(x)dx = -sin(x) +C$ 10.3) $\int tan(x)dx = -ln|cos(x)| +C$ 10.4) $\int cot(s)dx = ln|sin(x)| +C$ 10.5) $\int sec^2(x)dx = tan(x) +C$ 11. 導數(shù)公式 11.1) $(C)'=0 $ 11.2) $(sin \,x)' = cos \,x$ 11.3) $(tan \,x)' = sec^2 \,x$ 11.4) $(sec \,x)' = sec \,xtan \,x$ 11.5) $(a^x)' = a^xln \,x $ 11.6) $(x^{\mu}) = \mu x^{\mu-1}$ 11.7) $(cos \,x)' = -sin \,x$ 11.8) $(cot \,x)' = -csc^2 \,x$ 11.9) $(csc \,x)' = -csc \,xcot \,x$ 11.10) $(e^x)' = e^x$ 11.11) $$(log_ax)' = \frac{1}{xln \,a}$$ 11.12) $$(ln \,x)' = \frac{1}{x} $$ 11.13) $$(arcsin \,x)' = \frac{1}{\sqrt{1-x^2}}$$ 11.14) $$(arccos \,x)' = -\frac{1}{\sqrt{1-x^2}}$$ 11.15) $$(arctan \,x)' = \frac{1}{1+x^2}$$ 11.16) $$(arccot \,x)' = -\frac{1}{1+x^2}$$ 12. 重要的極限 12.1) $$\lim_{x\to 0} \,{\frac{\sin x}{x}} = 1$$ 12.2) $$\lim_{x\to \infty} \,{({1+ \frac{1}{x}})}^x = e$$

說明：

• \pi 表示希臘字母 π，\infty 表示 ∞。更多的符號請參見：http://www.math.harvard.edu/texman/node21.html
• \frac{分子}{分母} 表示分數(shù)。另外，\tfrac{分子}{分母} 表示小號的分數(shù)
• \sqrt{被開方數(shù)} 表示平方根。另外，\sqrt[n]{x} 表示 n 次方根
• \sum_{下標}^{上標} 表示求和符號。另外，\prod 表示乘積符號，\int 表示積分符號
• _{下標} 和 ^{上標} 可以用在任何地方。如果上下標只是一個字符，可以省略 { 和 }
• 此外，\ldots 和 \cdots 都表示省略號，前者排在基線上，后者排在中間
• 還有：\pm：±、\times：×、\div：÷

回車換行

點擊一次【回車】，結果顯示為一個空格；點擊兩次【回車】，文檔內(nèi)容才出現(xiàn)換行但是此時的行距較大。

處理：在文字末尾輸入 2 個及以上的空格，再點擊回車即可實現(xiàn)回車換行。

markdown更改圖片大小

1、使用Mou編輯器方法

原始圖像,markdown格式

更改大小

或

可以省略高度

2、如果使用的是簡書自帶的markdown編輯器

原始圖像


更改大小


只需要將后面的寬度更改就可以了.高度會自動變的不需要設置.

3、使用HTML

只需要更改上面的屬性width或height的值就可以了.

注意：每家的markdown編輯器語法會有所不同,因此在一個編輯器下寫的markdown復制到另一家的編輯器下,顯示可能會有差異.對于新手來說簡書自帶的markdown編輯差不多已經(jīng)夠用了

總結

以上是生活随笔為你收集整理的博客编辑神器：Markdown编辑器的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。