Markdown 教程

Markdown 標(biāo)題

Markdown 標(biāo)題有兩種格式。

1帜平、使用 = 和 - 標(biāo)記一級和二級標(biāo)題

我展示的是一級標(biāo)題
=================

我展示的是二級標(biāo)題
-----------------

顯示效果如下圖:

img

2、使用 # 號標(biāo)記

使用 # 號可表示 1-6 級標(biāo)題剪菱,一級標(biāo)題對應(yīng)一個(gè) # 號栖茉,二級標(biāo)題對應(yīng)兩個(gè) # 號,以此類推窖铡。

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

顯示效果如下圖:

img

Markdown 段落

Markdown 段落沒有特殊的格式疗锐,直接編寫文字就好坊谁,段落的換行是使用兩個(gè)以上空格加上回車。

img

img

當(dāng)然也可以在段落后面使用一個(gè)空行來表示重新開始一個(gè)段落滑臊。

字體

Markdown 可以使用以下幾種字體:

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

分隔線

你可以在一行中用三個(gè)以上的星號*口芍、減號-、底線-來建立一個(gè)分隔線雇卷,行內(nèi)不能有其他東西鬓椭。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:

***

* * *

*****

- - -

----------





刪除線

如果段落上的文字要添加刪除線关划,只需要在文字的兩端加上兩個(gè)波浪線 ~~ 即可小染,實(shí)例如下:

RUNOOB.COM
GOOGLE.COM
~~BAIDU.COM~~

RUNOOB.COM
GOOGLE.COM
BAIDU.COM

下劃線

下劃線可以通過 HTML 的 <u> 標(biāo)簽來實(shí)現(xiàn):

<u>帶下劃線文本</u>

<u>帶下劃線文本</u>
但是簡書的Markdown不顯示這種格式,暫時(shí)還沒找到解決辦法贮折。

腳注

腳注是對文本的補(bǔ)充說明裤翩。

Markdown 腳注的格式如下:

[^要注明的文本]

以下實(shí)例演示了腳注的用法:

創(chuàng)建腳注格式類似這樣 [^RUNOOB]。

[^RUNOOB]: 菜鳥教程 -- 學(xué)的不僅是技術(shù)调榄,更是夢想S辉!每庆!

創(chuàng)建腳注格式類似這樣 [1]筐带。

Markdown 列表

Markdown 支持有序列表和無序列表。

無序列表使用星號(*)缤灵、加號(+)或是減號(-)作為列表標(biāo)記:

* 第一項(xiàng)
* 第二項(xiàng)
* 第三項(xiàng)

+ 第一項(xiàng)
+ 第二項(xiàng)
+ 第三項(xiàng)


- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)
  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)
  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)
    有序列表使用數(shù)字并加上 . 號來表示伦籍,如:
  1. 第一項(xiàng)
  2. 第二項(xiàng)
  3. 第三項(xiàng)

列表嵌套

列表嵌套只需在子列表中的選項(xiàng)添加四個(gè)空格即可:

1. 第一項(xiàng):
    - 第一項(xiàng)嵌套的第一個(gè)元素
    - 第一項(xiàng)嵌套的第二個(gè)元素
2. 第二項(xiàng):
    - 第二項(xiàng)嵌套的第一個(gè)元素
    - 第二項(xiàng)嵌套的第二個(gè)元素
  1. 第一項(xiàng):
    • 第一項(xiàng)嵌套的第一個(gè)元素
    • 第一項(xiàng)嵌套的第二個(gè)元素
  2. 第二項(xiàng):
    • 第二項(xiàng)嵌套的第一個(gè)元素
    • 第二項(xiàng)嵌套的第二個(gè)元素

Markdown 區(qū)塊

Markdown 區(qū)塊引用是在段落開頭使用 > 符號 ,然后后面緊跟一個(gè)空格符號:

> 區(qū)塊引用
> 菜鳥教程
> 學(xué)的不僅是技術(shù)更是夢想

區(qū)塊引用
菜鳥教程
學(xué)的不僅是技術(shù)更是夢想
另外區(qū)塊是可以嵌套的腮出,一個(gè) > 符號是最外層帖鸦,兩個(gè) > 符號是第一層嵌套,以此類推:

> 最外層
> > 第一層嵌套
> > > 第二層嵌套

最外層

第一層嵌套

第二層嵌套

區(qū)塊中使用列表

區(qū)塊中使用列表實(shí)例如下:

> 區(qū)塊中使用列表
> 1. 第一項(xiàng)
> 2. 第二項(xiàng)
> + 第一項(xiàng)
> + 第二項(xiàng)
> + 第三項(xiàng)

區(qū)塊中使用列表

  1. 第一項(xiàng)
  2. 第二項(xiàng)
  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)

列表中使用區(qū)塊

如果要在列表項(xiàng)目內(nèi)放進(jìn)區(qū)塊利诺,那么就需要在 > 前添加四個(gè)空格的縮進(jìn)富蓄。

區(qū)塊中使用列表實(shí)例如下:

* 第一項(xiàng)
    > 菜鳥教程
    > 學(xué)的不僅是技術(shù)更是夢想
* 第二項(xiàng)
  • 第一項(xiàng)

    菜鳥教程
    學(xué)的不僅是技術(shù)更是夢想

  • 第二項(xiàng)

Markdown 代碼

如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號把它包起來(`),例如:

`printf()` 函數(shù)

printf() 函數(shù)

代碼區(qū)塊

代碼區(qū)塊使用 4 個(gè)空格或者一個(gè)制表符(Tab 鍵)慢逾。

實(shí)例如下:


img

顯示結(jié)果如下:


img

你也可以用 ``` 包裹一段代碼立倍,并指定一種語言(也可以不指定):

$(document).ready(function () {
    alert('RUNOOB');
});

Markdown 鏈接

鏈接使用方法如下:

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

或者

<鏈接地址>

例如:

這是一個(gè)鏈接 [菜鳥教程](https://www.runoob.com)

顯示結(jié)果如下:



直接使用鏈接地址:

<https://www.runoob.com>

顯示結(jié)果如下:


高級鏈接

鏈接也可以用變量來代替,文檔末尾附帶變量地址:
這個(gè)鏈接用 1 作為網(wǎng)址變量 [Google][1]
這個(gè)鏈接用 runoob 作為網(wǎng)址變量 [Runoob][runoob]
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)

  [1]: http://www.google.com/
  [runoob]: http://www.runoob.com/

顯示結(jié)果如下:


Markdown 圖片

Markdown 圖片語法格式如下:

[圖片上傳失敗...(image-42be39-1584433568278)]

[圖片上傳失敗...(image-326f97-1584433568278)]
  • 開頭一個(gè)感嘆號 !
  • 接著一個(gè)方括號侣滩,里面放上圖片的替代文字
  • 接著一個(gè)普通括號口注,里面放上圖片的網(wǎng)址,最后還可以用引號包住并加上選擇性的 'title' 屬性的文字君珠。

使用實(shí)例:

[圖片上傳失敗...(image-1d7dda-1584433568278)]

[圖片上傳失敗...(image-7be98-1584433568278)]

顯示結(jié)果如下:



當(dāng)然寝志,你也可以像網(wǎng)址那樣對圖片網(wǎng)址使用變量:

這個(gè)鏈接用 1 作為網(wǎng)址變量 [RUNOOB][1].
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)

[1]: http://static.runoob.com/images/runoob-logo.png

顯示結(jié)果如下:



Markdown 還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的 <img> 標(biāo)簽材部。

<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">

顯示結(jié)果如下:

Markdown 表格

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

語法格式如下:

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

以上代碼顯示結(jié)果如下:


對齊方式

我們可以設(shè)置表格的對齊方式:

-: 設(shè)置內(nèi)容和標(biāo)題欄居右對齊乐导。
:- 設(shè)置內(nèi)容和標(biāo)題欄居左對齊苦丁。
:-: 設(shè)置內(nèi)容和標(biāo)題欄居中對齊。

實(shí)例如下:

| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

以上代碼顯示結(jié)果如下:

Markdown 高級技巧

支持的 HTML 元素

不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽物臂,都可以直接在文檔里面用 HTML 撰寫旺拉。

目前支持的 HTML 元素有:等 ,如:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦

輸出結(jié)果為:

轉(zhuǎn)義

Markdown 使用了很多特殊符號來表示特定的意義棵磷,如果需要顯示特定的符號則需要使用轉(zhuǎn)義字符蛾狗,Markdown 使用反斜杠轉(zhuǎn)義特殊字符:

**文本加粗** 
\*\* 正常顯示星號 \*\*

輸出結(jié)果為:



Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   下劃線
{}  花括號
[]  方括號
()  小括號
#   井字號
+   加號
-   減號
.   英文句點(diǎn)
!   感嘆號

公式

當(dāng)你需要在編輯器中插入數(shù)學(xué)公式時(shí),可以使用兩個(gè)美元符 $$ 包裹 TeX 或 LaTeX 格式的數(shù)學(xué)公式來實(shí)現(xiàn)仪媒。提交后沉桌,問答和文章頁會(huì)根據(jù)需要加載 Mathjax 對數(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é)果為:


typora 畫流程圖规丽、時(shí)序圖(順序圖)蒲牧、甘特圖

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



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

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

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

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

?```mermaid
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)流程圖源碼格式:

?```flow
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)流程圖源碼格式(橫向):

?```flow
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í)序圖源碼樣例:

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

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

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

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

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

8似谁、甘特圖樣例:

?```mermaid
%% 語法示例
        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 測試
        功能測試                              :active, a1, after des3, 3d
        壓力測試                               :after a1  , 20h
        測試報(bào)告                               : 48h
?```

效果圖如下:


img

[注]全文整合自菜鳥教程傲绣,轉(zhuǎn)載請注明出處


  1. 菜鳥教程 -- 學(xué)的不僅是技術(shù),更是夢想9ぁM核小! ?

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末塞琼,一起剝皮案震驚了整個(gè)濱河市菠净,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖毅往,帶你破解...
    沈念sama閱讀 219,589評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件牵咙,死亡現(xiàn)場離奇詭異,居然都是意外死亡攀唯,警方通過查閱死者的電腦和手機(jī)洁桌,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,615評論 3 396
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來革答,“玉大人战坤,你說我怎么就攤上這事〔泄眨” “怎么了途茫?”我有些...
    開封第一講書人閱讀 165,933評論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長溪食。 經(jīng)常有香客問我囊卜,道長,這世上最難降的妖魔是什么错沃? 我笑而不...
    開封第一講書人閱讀 58,976評論 1 295
  • 正文 為了忘掉前任栅组,我火速辦了婚禮,結(jié)果婚禮上枢析,老公的妹妹穿的比我還像新娘玉掸。我一直安慰自己,他們只是感情好醒叁,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,999評論 6 393
  • 文/花漫 我一把揭開白布司浪。 她就那樣靜靜地躺著,像睡著了一般把沼。 火紅的嫁衣襯著肌膚如雪啊易。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,775評論 1 307
  • 那天饮睬,我揣著相機(jī)與錄音租谈,去河邊找鬼。 笑死捆愁,一個(gè)胖子當(dāng)著我的面吹牛割去,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播牙瓢,決...
    沈念sama閱讀 40,474評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼劫拗,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了矾克?” 一聲冷哼從身側(cè)響起页慷,我...
    開封第一講書人閱讀 39,359評論 0 276
  • 序言:老撾萬榮一對情侶失蹤憔足,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后酒繁,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體滓彰,經(jīng)...
    沈念sama閱讀 45,854評論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,007評論 3 338
  • 正文 我和宋清朗相戀三年州袒,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了揭绑。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,146評論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡郎哭,死狀恐怖他匪,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情夸研,我是刑警寧澤邦蜜,帶...
    沈念sama閱讀 35,826評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站亥至,受9級特大地震影響悼沈,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜姐扮,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,484評論 3 331
  • 文/蒙蒙 一絮供、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧茶敏,春花似錦壤靶、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,029評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至胀屿,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間包雀,已是汗流浹背宿崭。 一陣腳步聲響...
    開封第一講書人閱讀 33,153評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留才写,地道東北人葡兑。 一個(gè)月前我還...
    沈念sama閱讀 48,420評論 3 373
  • 正文 我出身青樓,卻偏偏與公主長得像赞草,于是被迫代替她去往敵國和親讹堤。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,107評論 2 356

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