Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言,它允許人們使用易讀易寫的純文本格式編寫文檔磅叛。
Markdown 語(yǔ)言在 2004 由約翰·格魯伯(英語(yǔ):John Gruber)創(chuàng)建俩由。
Markdown 編寫的文檔可以導(dǎo)出 HTML 废酷、Word、圖像逛艰、PDF、Epub 等多種格式的文檔。
Markdown 編寫的文檔后綴為 .md, .markdown址否。
Markdown 標(biāo)題
Markdown 標(biāo)題有兩種格式。
(1)使用 = 和 - 標(biāo)記一級(jí)和二級(jí)標(biāo)題
= 和 - 標(biāo)記語(yǔ)法格式如下:
我展示的是一級(jí)標(biāo)題
我展示的是二級(jí)標(biāo)題
(2)使用 # 號(hào)標(biāo)記
使用 # 號(hào)可表示 1-6 級(jí)標(biāo)題碎紊,一級(jí)標(biāo)題對(duì)應(yīng)一個(gè) # 號(hào)佑附,二級(jí)標(biāo)題對(duì)應(yīng)兩個(gè) # 號(hào),以此類推仗考。
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
四級(jí)標(biāo)題
五級(jí)標(biāo)題
六級(jí)標(biāo)題
Markdown 段落
Markdown 段落沒有特殊的格式音同,直接編寫文字就好,段落的換行是使用兩個(gè)以上空格加上回車秃嗜。
當(dāng)然也可以在段落后面使用一個(gè)空行來表示重新開始一個(gè)段落权均。
字體
Markdown 可以使用以下幾種字體:
斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本
分隔線
你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)锅锨、底線來建立一個(gè)分隔線叽赊,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格必搞。下面每種寫法都可以建立分隔線:
刪除線
如果段落上的文字要添加刪除線必指,只需要在文字的兩端加上兩個(gè)波浪線 ~~ 即可,實(shí)例如下:
RUNOOB.COM
GOOGLE.COM
BAIDU.COM
下劃線
下劃線可以通過 HTML 的 <u> 標(biāo)簽來實(shí)現(xiàn):
<u>帶下劃線文本</u>
腳注
腳注是對(duì)文本的補(bǔ)充說明恕洲。
Markdown 腳注的格式如下:
[^要注明的文本]
以下實(shí)例演示了腳注的用法:
創(chuàng)建腳注格式類似這樣 [1]塔橡。
Markdown 列表
Markdown 支持有序列表和無序列表梅割。
無序列表使用星號(hào)(*)、加號(hào)(+)或是減號(hào)(-)作為列表標(biāo)記葛家,這些標(biāo)記后面要添加一個(gè)空格户辞,然后再填寫內(nèi)容:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
有序列表使用數(shù)字并加上 . 號(hào)來表示,如:
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
列表嵌套
列表嵌套只需在子列表中的選項(xiàng)前面添加四個(gè)空格即可:
- 第一項(xiàng):
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
- 第二項(xiàng):
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素
Markdown 區(qū)塊
Markdown 區(qū)塊引用是在段落開頭使用 > 符號(hào) 癞谒,然后后面緊跟一個(gè)空格符號(hào):
區(qū)塊引用
菜鳥教程
學(xué)的不僅是技術(shù)更是夢(mèng)想
另外區(qū)塊是可以嵌套的底燎,一個(gè) > 符號(hào)是最外層,兩個(gè) > 符號(hào)是第一層嵌套扯俱,以此類推:
最外層
第一層嵌套
第二層嵌套
區(qū)塊中使用列表
區(qū)塊中使用列表實(shí)例如下:
區(qū)塊中使用列表
- 第一項(xiàng)
- 第二項(xiàng)
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)
列表中使用區(qū)塊
如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)區(qū)塊书蚪,那么就需要在 > 前添加四個(gè)空格的縮進(jìn)。
列表中使用區(qū)塊實(shí)例如下:
- 第一項(xiàng)
菜鳥教程
學(xué)的不僅是技術(shù)更是夢(mèng)想 - 第二項(xiàng)
Markdown 代碼
如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號(hào)把它包起來(`)迅栅,例如:
printf()
函數(shù)
代碼區(qū)塊
代碼區(qū)塊使用 4 個(gè)空格或者一個(gè)制表符(Tab 鍵)殊校。
實(shí)例如下:
顯示結(jié)果如下:
你也可以用 ``` 包裹一段代碼,并指定一種語(yǔ)言(也可以不指定):
$(document).ready(function () {
alert('RUNOOB');
});
Markdown 鏈接
鏈接使用方法如下:
或者
<鏈接地址>
例如:這是一個(gè)鏈接 菜鳥教程
直接使用鏈接地址:https://www.runoob.com
高級(jí)鏈接
我們可以通過變量來設(shè)置一個(gè)鏈接读存,變量賦值在文檔末尾進(jìn)行:
這個(gè)鏈接用 1 作為網(wǎng)址變量 Google
這個(gè)鏈接用 runoob 作為網(wǎng)址變量 Runoob
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
Markdown 圖片
Markdown 圖片語(yǔ)法格式如下:
開頭一個(gè)感嘆號(hào) !
接著一個(gè)方括號(hào)为流,里面放上圖片的替代文字
接著一個(gè)普通括號(hào),里面放上圖片的網(wǎng)址让簿,最后還可以用引號(hào)包住并加上選擇性的 'title' 屬性的文字敬察。
當(dāng)然,你也可以像網(wǎng)址那樣對(duì)圖片網(wǎng)址使用變量:
這個(gè)鏈接用 1 作為網(wǎng)址變量 RUNOOB.
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)
Markdown 還沒有辦法指定圖片的高度與寬度尔当,如果你需要的話莲祸,你可以使用普通的 <img> 標(biāo)簽。
<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">
Markdown 表格
Markdown 制作表格使用 | 來分隔不同的單元格椭迎,使用 - 來分隔表頭和其他行锐帜。
語(yǔ)法格式如下:
表頭 | 表頭 |
---|---|
單元格 | 單元格 |
單元格 | 單元格 |
對(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ì)齊 |
---|---|---|
單元格 | 單元格 | 單元格 |
單元格 | 單元格 | 單元格 |
Markdown 高級(jí)技巧
支持的 HTML 元素
不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽,都可以直接在文檔里面用 HTML 撰寫简软。
目前支持的 HTML 元素有:<kbd> <b> <i> <em>
等 蛮拔,如:
使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦
轉(zhuǎn)義
Markdown 使用了很多特殊符號(hào)來表示特定的意義,如果需要顯示特定的符號(hào)則需要使用轉(zhuǎn)義字符痹升,Markdown 使用反斜杠轉(zhuǎn)義特殊字符:
文本加粗
** 正常顯示星號(hào) **
Markdown 支持以下這些符號(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)行渲染踱卵。如:
-
菜鳥教程 -- 學(xué)的不僅是技術(shù),更是夢(mèng)想!M锷啊! ?