Markdown入門教程

封面 id=80003805

Markdown簡(jiǎn)介

Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言,創(chuàng)始人為約翰·格魯伯(英語(yǔ):John Gruber)。 它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔。這種語(yǔ)言吸收了很多在電子郵件中已有的純文本標(biāo)記的特性。
由于Markdown的輕量化、易讀易寫特性,并且對(duì)于圖片,圖表、數(shù)學(xué)式都有支持,許多網(wǎng)站都廣泛使用Markdown來撰寫幫助文檔或是用于論壇上發(fā)表消息。 如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、簡(jiǎn)書等,甚至還能被使用來撰寫電子書。
對(duì)于程序員來講,使用Markdown做筆記比使用.txt和word要方便很多!

編輯器

本教程使用Typora講解Markdown的基本語(yǔ)法,這是一個(gè)跨平臺(tái)的編輯器,支持windows、MasOS和Linux操作系統(tǒng),導(dǎo)出支持HTML、PDF、Word、圖片等類型的文件。
可以在Typora官網(wǎng)上下載此編輯器 Typora官網(wǎng)

添加擴(kuò)展語(yǔ)法

在官網(wǎng)上下載安裝完Typora后,進(jìn)入設(shè)置添加擴(kuò)展語(yǔ)法,
方法如下:


在文件中點(diǎn)擊偏好設(shè)置

在Markdown里把擴(kuò)展語(yǔ)法全部勾上

隨后,我們就能使用Markdown的擴(kuò)展語(yǔ)法了。

Markdown教程

1. 標(biāo)題

使用“#”標(biāo)記

# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題

效果如下:

一級(jí)標(biāo)題

二級(jí)標(biāo)題

三級(jí)標(biāo)題

四級(jí)標(biāo)題

五級(jí)標(biāo)題
六級(jí)標(biāo)題

2. 字體

可以使用如下字體:

*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___

效果如下:
斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本

3. 列表

無序表

使用*或+或-減號(hào)作為列表標(biāo)記

* one
* two
* three

+ 1
+ 2
+ 3

- 一
- 二
- 三

效果如下:

  • 1
  • 2
  • 3

有序表

使用數(shù)字加 . 即可,如:

1. 1
2. 2
3. 3

效果如下:

  1. 1
  2. 2
  3. 3

列表嵌套

在子列表前面加四個(gè)空格或者兩個(gè)Tab即可

*  a
    1. b
    2. c
    3. d
* e
    1. f
    2. g

效果如下:

  • a
    1. b
    2. c
    3. d
  • e
    1. f
    2. g

4. 區(qū)塊

一個(gè)單獨(dú)的區(qū)塊

在開頭使用>即可,如:

> 區(qū)
> 塊

效果如下:

區(qū)

區(qū)塊嵌套

區(qū)塊也可以像列表那樣可以嵌套一個(gè)>最外層,兩個(gè)>則是第二層,如:

> 區(qū)
> >塊
>>>嵌
>>>>套

區(qū)

區(qū)塊與列表的混用

在區(qū)塊中是可以使用列表的,如:

> 姓名:
> 學(xué)號(hào):
> 成績(jī):
>   * 數(shù)學(xué)
>   * 語(yǔ)文
>   * 英語(yǔ)
> 日期

效果如下:

姓名:
學(xué)號(hào):
成績(jī):

  • 數(shù)學(xué)
  • 語(yǔ)文
  • 英語(yǔ)
    日期

當(dāng)然,在列表中也能使用區(qū)塊:

* 姓名:
* 學(xué)號(hào):
* 成績(jī):
>   * 數(shù)學(xué)
>   * 語(yǔ)文
>   * 英語(yǔ)
* 日期:

效果如下:

  • 姓名:
  • 學(xué)號(hào):
  • 成績(jī):
  • 數(shù)學(xué)
  • 語(yǔ)文
  • 英語(yǔ)
  • 日期:

5. 代碼塊

可以在代碼開頭前用```加語(yǔ)言名的方式增加代碼塊,再用```標(biāo)記代碼的結(jié)束,如:

```C
int main(void)
{
  return 0;
}```

效果如下:

int main(void)
{
  return 0;
}

6. 鏈接

使用如下兩種方式添加鏈接:

[鏈接名稱](鏈接地址)
<鏈接地址>

使用簡(jiǎn)書舉例:

[簡(jiǎn)書](http://www.lxweimin.com/)
<http://www.lxweimin.com/>

效果如下:
簡(jiǎn)書
http://www.lxweimin.com/

7. 圖片

使用如下方式添加圖片:

![alt 屬性文本](圖片地址 "可選標(biāo)題")

舉例:

![id=67013895](https://upload-images.jianshu.io/upload_images/26493533-f1acd5ec0ad5321f.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果如下:


id=67013895

Markdown 還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的 <img> 標(biāo)簽。,如:
<img src="https://upload-images.jianshu.io/upload_images/26493533-f1acd5ec0ad5321f.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" width="50%">

8. 表格

表格的制作

Markdown 制作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行。
舉例:

|  表頭   | 表頭  |
|  ----  | ----  |
| 單元格  | 單元格 |
| 單元格  | 單元格 |

我們能得到:

表頭 表頭
單元格 單元格
單元格 單元格

表格的對(duì)齊方式

我們可以設(shè)置表格的對(duì)齊方式:
-: 設(shè)置內(nèi)容和標(biāo)題欄居右對(duì)齊。
:- 設(shè)置內(nèi)容和標(biāo)題欄居左對(duì)齊。
:-: 設(shè)置內(nèi)容和標(biāo)題欄居中對(duì)齊。
實(shí)例如下:

| 左對(duì)齊 | 右對(duì)齊 | 居中對(duì)齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
左對(duì)齊 右對(duì)齊 居中對(duì)齊
單元格 單元格 單元格
單元格 單元格 單元格

9.其他的一些語(yǔ)法

(部分語(yǔ)法屬于擴(kuò)展語(yǔ)法,簡(jiǎn)書可能會(huì)不支持,所以部分效果無法展示)

高亮

在需要重點(diǎn)標(biāo)注的詞句兩側(cè)加上==

我滴好兄弟,你可真==聰明==啊!

我滴好兄弟,你可真==聰明==??!

下標(biāo)

下標(biāo)的詞句兩側(cè)加上~

H~2~O

H2O

上標(biāo)

上標(biāo)的詞句兩側(cè)加上^

y = e^x+1^

y = ex+1

轉(zhuǎn)義

如果需要顯示特定的符號(hào)則需要使用轉(zhuǎn)義字符,Markdown 使用反斜杠轉(zhuǎn)義特殊字符:

**文本加粗** 
\*\* 正常顯示星號(hào) \*\*

文本加粗
** 正常顯示星號(hào) **

公式

當(dāng)你需要在編輯器中插入數(shù)學(xué)公式時(shí),可以使用兩個(gè)美元符 $$ 包裹 TeX 或 LaTeX 格式的數(shù)學(xué)公式來實(shí)現(xiàn)。提交后,問答和文章頁(yè)會(huì)根據(jù)需要加載 Mathjax 對(duì)數(shù)學(xué)公式進(jìn)行渲染。如

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

結(jié)果為:
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \\ \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \\ \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \\ \end{vmatrix} ${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}

typora 畫流程圖、時(shí)序圖(順序圖)、甘特圖

復(fù)制以下代碼使用 typora 的源碼模式粘貼到編輯器中查看效果:


源代碼模式進(jìn)入方法

以下幾個(gè)實(shí)例效果圖如下:

1、橫向流程圖源碼格式:

graph LR
A[方形] -->B(圓角)
    B --> C{條件a}
    C -->|a=1| D[結(jié)果1]
    C -->|a=2| E[結(jié)果2]
    F[橫向流程圖]

2、豎向流程圖源碼格式:

graph TD
A[方形] --> B(圓角)
    B --> C{條件a}
    C --> |a=1| D[結(jié)果1]
    C --> |a=2| E[結(jié)果2]
    F[豎向流程圖]

3、標(biāo)準(zhǔn)流程圖源碼格式:

st=>start: 開始框
op=>operation: 處理框
cond=>condition: 判斷框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 輸入輸出框
e=>end: 結(jié)束框
st->op->cond
cond(yes)->io->e
cond(no)->sub1(right)->op

4、標(biāo)準(zhǔn)流程圖源碼格式(橫向):

st=>start: 開始框
op=>operation: 處理框
cond=>condition: 判斷框(是或否?)
sub1=>subroutine: 子流程
io=>inputoutput: 輸入輸出框
e=>end: 結(jié)束框
st(right)->op(right)->cond
cond(yes)->io(bottom)->e
cond(no)->sub1(right)->op

5、UML時(shí)序圖源碼樣例:

對(duì)象A->對(duì)象B: 對(duì)象B你好嗎?(請(qǐng)求)
Note right of 對(duì)象B: 對(duì)象B的描述
Note left of 對(duì)象A: 對(duì)象A的描述(提示)
對(duì)象B-->對(duì)象A: 我很好(響應(yīng))
對(duì)象A->對(duì)象B: 你真的好嗎?

6、UML時(shí)序圖源碼復(fù)雜樣例:

Title: 標(biāo)題:復(fù)雜使用
對(duì)象A->對(duì)象B: 對(duì)象B你好嗎?(請(qǐng)求)
Note right of 對(duì)象B: 對(duì)象B的描述
Note left of 對(duì)象A: 對(duì)象A的描述(提示)
對(duì)象B-->對(duì)象A: 我很好(響應(yīng))
對(duì)象B->小三: 你好嗎
小三-->>對(duì)象A: 對(duì)象B找我了
對(duì)象A->對(duì)象B: 你真的好嗎?
Note over 小三,對(duì)象B: 我們是朋友
participant C
Note right of C: 沒人陪我玩

7、UML標(biāo)準(zhǔn)時(shí)序圖樣例:

%% 時(shí)序圖例子,-> 直線,-->虛線,->>實(shí)線箭頭
  sequenceDiagram
    participant 張三
    participant 李四
    張三->王五: 王五你好嗎?
    loop 健康檢查
        王五->王五: 與疾病戰(zhàn)斗
    end
    Note right of 王五: 合理 食物 <br/>看醫(yī)生...
    李四-->>張三: 很好!
    王五->李四: 你怎么樣?
    李四-->王五: 很好!

8、甘特圖樣例:

%% 語(yǔ)法示例
        gantt
        dateFormat  YYYY-MM-DD
        title 軟件開發(fā)甘特圖
        section 設(shè)計(jì)
        需求                      :done,    des1, 2014-01-06,2014-01-08
        原型                      :active,  des2, 2014-01-09, 3d
        UI設(shè)計(jì)                     :         des3, after des2, 5d
    未來任務(wù)                     :         des4, after des3, 5d
        section 開發(fā)
        學(xué)習(xí)準(zhǔn)備理解需求                      :crit, done, 2014-01-06,24h
        設(shè)計(jì)框架                             :crit, done, after des2, 2d
        開發(fā)                                 :crit, active, 3d
        未來任務(wù)                              :crit, 5d
        耍                                   :2d
        section 測(cè)試
        功能測(cè)試                              :active, a1, after des3, 3d
        壓力測(cè)試                               :after a1  , 20h
        測(cè)試報(bào)告                               : 48h

參考資料

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 227,401評(píng)論 6 531
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 98,011評(píng)論 3 413
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 175,263評(píng)論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,543評(píng)論 1 307
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 71,323評(píng)論 6 404
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 54,874評(píng)論 1 321
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 42,968評(píng)論 3 439
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,095評(píng)論 0 286
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 48,605評(píng)論 1 331
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 40,551評(píng)論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 42,720評(píng)論 1 369
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,242評(píng)論 5 355
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 43,961評(píng)論 3 345
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,358評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,612評(píng)論 1 280
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 51,330評(píng)論 3 390
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 47,690評(píng)論 2 370

推薦閱讀更多精彩內(nèi)容

  • 顏色 1.標(biāo)題 = 表示一級(jí)標(biāo)題- 表示二級(jí)標(biāo)題# 表示一級(jí)標(biāo)題## 表示二級(jí)標(biāo)題### 表示三級(jí)標(biāo)題(以此類...
    花開半時(shí)偏妍閱讀 165評(píng)論 0 1
  • 寫在前面 之前在 CSDN 寫過一段時(shí)間的博客,使用的是傳統(tǒng)的文本。最近利用 Github+Hexo 搭建了一個(gè)靜...
    Lucky_Light閱讀 1,641評(píng)論 0 21
  • Markdown說到底就是一種標(biāo)記語(yǔ)言,平常我們記錄學(xué)習(xí)筆記,可以用純文本txt或word,但現(xiàn)在我們也可選用Ma...
    wuxie閱讀 246評(píng)論 0 0
  • 新手可以使用 typora 編輯器:https://www.typora.io/ Markdown 標(biāo)題 Mark...
    流浪往生閱讀 202評(píng)論 0 0
  • We believe that writing is about content, about what you ...
    ChangingFond閱讀 278評(píng)論 0 0