markdown基本語法

前言

筆者最近想找一個(gè)博客來記載一些web開發(fā)方面的知識(shí),偶然發(fā)現(xiàn)簡(jiǎn)書的體系甚好,并且完美支持富文本和markdown的寫法昌屉,所以就準(zhǔn)備在簡(jiǎn)書扎根啦,正所謂 兵馬未動(dòng)茵瀑,糧草先行间驮,在此呢,先記錄一下markdown的基本語法马昨,方面忘記的時(shí)候來回顧一下竞帽,如此,甚好甚好~

語法介紹

一鸿捧、標(biāo)題

標(biāo)題的實(shí)現(xiàn)可以有兩種形式屹篓,我們比較常用的是第一種

  1. 使用#號(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)題
  1. 使用 = 和 - 來標(biāo)記一級(jí)和二級(jí)標(biāo)題
    = 和 - 標(biāo)記語法格式如下:
我展示的是一級(jí)標(biāo)題
=================

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

總結(jié):標(biāo)題這塊語法相對(duì)簡(jiǎn)單,我這里就不做演示了恳邀,大家可以自己試一下

二懦冰、字體

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

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

顯示效果如下:


斜體文本
斜體文本
粗體文本
粗體文本
粗斜體文本
粗斜體文本


三、分割線

你可以在一行中用三個(gè)以上的星號(hào)谣沸、減號(hào)刷钢、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西乳附。你也可以在星號(hào)或是減號(hào)中間插入空格内地。下面每種寫法都可以建立分隔線:

***

* * *

*****

- - -

----------

顯示效果如下:






四、刪除線

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

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

顯示效果如下:

RUNOOB.COM
GOOGLE.COM
BAIDU.COM

五、下劃線

下劃線可以通過 HTML 的 <u> 標(biāo)簽來實(shí)現(xiàn)(好像在簡(jiǎn)書不支持):

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

顯示效果如下:

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

六举农、腳注

腳注是對(duì)文本的補(bǔ)充說明荆针。Markdown 腳注的格式如下:

[^要注明的文本]

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

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

[^注解]: 古之立大事者 -- 不惟有超世之才颁糟,亦必有堅(jiān)韌不拔之志:奖场!棱貌!

顯示效果如下:

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

七、列表

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

無序列表使用星號(hào)(*)今魔、加號(hào)(+)或是減號(hào)(-)作為列表標(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ù)字并加上 . 號(hào)來表示,如:

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

顯示效果如下:

  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è)元素
八障贸、鏈接

鏈接使用方法如下:

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

或者

<鏈接地址>

例如:

這是一個(gè)鏈接 [百度](https://www.baiducom)

顯示效果如下:

這是一個(gè)鏈接 百度

直接使用鏈接地址:

<https://www.baiducom>

顯示效果如下:

https://www.baiducom

鏈接也可以用變量來代替错森,文檔末尾附帶變量地址:

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

顯示效果如下:

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

九、圖片

Markdown 圖片語法格式如下:

![alt 屬性文本](圖片地址)

![alt 屬性文本](圖片地址 "可選標(biāo)題")
  • 開頭一個(gè)感嘆號(hào) !
  • 接著一個(gè)方括號(hào)篮洁,里面放上圖片的替代文字
  • 接著一個(gè)普通括號(hào)问词,里面放上圖片的網(wǎng)址,最后還可以用引號(hào)包住并加上選擇性的 'title' 屬性的文字嘀粱。

使用實(shí)例:

![貓咪](https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

![狗狗](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1581510620269&di=1834d9a7fe222e90186c9bfde76adb7a&imgtype=0&src=http%3A%2F%2Fimg.juimg.com%2Ftuku%2Fyulantu%2F121005%2F219049-1210051Q25899.jpg "狗子")

顯示結(jié)果如下:

貓咪
狗狗

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

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

[1]: https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240

顯示結(jié)果如下:

這個(gè)鏈接用 1 作為網(wǎng)址變量
狗子

.
然后在文檔的結(jié)尾為變量賦值(網(wǎng)址)

Markdown 還沒有辦法指定圖片的高度與寬度辰狡,如果你需要的話锋叨,你可以使用普通的 <img> 標(biāo)簽(有的不支持此功能,比如簡(jiǎn)書,所以這里不再做示例展示)宛篇。

<img src="https://upload-images.jianshu.io/upload_images/21292023-95d4d4da779d2ec1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240">

十娃磺、代碼

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

`console.log()` 函數(shù)

顯示效果如下:

console.log() 函數(shù)

代碼區(qū)塊:用 ``` 包裹一段代碼叫倍,并指定一種語言(也可以不指定):

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

顯示效果如下:

$(document).ready(function () {
    alert('RUNOOB');
});
十一偷卧、表格

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

語法格式如下:

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

顯示效果如下:

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

我們可以設(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ì)齊
單元格 單元格 單元格
單元格 單元格 單元格
十二晌梨、區(qū)塊

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

> 區(qū)塊引用
> 簡(jiǎn)書
> 簡(jiǎn)述你的夢(mèng)想

顯示效果如下:

區(qū)塊引用
簡(jiǎn)書
簡(jiǎn)述你的夢(mèng)想

另外區(qū)塊是可以嵌套的,一個(gè) > 符號(hào)是最外層仔蝌,兩個(gè) > 符號(hào)是第一層嵌套泛领,以此類推:

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

顯示效果如下:

最外層

第一層嵌套

第二層嵌套

區(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)

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

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

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

顯示效果如下:

  • 第一項(xiàng)

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

  • 第二項(xiàng)
十三渊鞋、高級(jí)技巧

1、支持的 HTML 元素

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

目前支持的 HTML 元素有:<kbd> <b> <i> <em>
等 ,如:

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

顯示效果如下:

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

2皿伺、轉(zhuǎn)義

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

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

顯示效果如下:

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

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

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

結(jié)語:以上就是我們比較會(huì)經(jīng)常用到的語法啦鸵鸥,當(dāng)然了奠滑,還有很多其他的功能,但是并不會(huì)很常用妒穴,比如插入公式宋税,寫流程圖等等,大家有興趣的可以自行研究一下讼油,本片到這里就結(jié)束了杰赛,歡迎大家關(guān)注和收藏哦~


  1. 古之立大事者 -- 不惟有超世之才,亦必有堅(jiān)韌不拔之志0ā7ν汀! ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末瘦赫,一起剝皮案震驚了整個(gè)濱河市辰晕,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌确虱,老刑警劉巖含友,帶你破解...
    沈念sama閱讀 206,482評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡窘问,警方通過查閱死者的電腦和手機(jī)辆童,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,377評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來惠赫,“玉大人把鉴,你說我怎么就攤上這事『盒危” “怎么了纸镊?”我有些...
    開封第一講書人閱讀 152,762評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)概疆。 經(jīng)常有香客問我逗威,道長(zhǎng),這世上最難降的妖魔是什么岔冀? 我笑而不...
    開封第一講書人閱讀 55,273評(píng)論 1 279
  • 正文 為了忘掉前任凯旭,我火速辦了婚禮,結(jié)果婚禮上使套,老公的妹妹穿的比我還像新娘罐呼。我一直安慰自己,他們只是感情好侦高,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,289評(píng)論 5 373
  • 文/花漫 我一把揭開白布嫉柴。 她就那樣靜靜地躺著,像睡著了一般奉呛。 火紅的嫁衣襯著肌膚如雪计螺。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,046評(píng)論 1 285
  • 那天瞧壮,我揣著相機(jī)與錄音登馒,去河邊找鬼。 笑死咆槽,一個(gè)胖子當(dāng)著我的面吹牛陈轿,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播秦忿,決...
    沈念sama閱讀 38,351評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼麦射,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了灯谣?” 一聲冷哼從身側(cè)響起法褥,我...
    開封第一講書人閱讀 36,988評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎酬屉,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,476評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡呐萨,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,948評(píng)論 2 324
  • 正文 我和宋清朗相戀三年杀饵,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片谬擦。...
    茶點(diǎn)故事閱讀 38,064評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡切距,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出惨远,到底是詐尸還是另有隱情谜悟,我是刑警寧澤,帶...
    沈念sama閱讀 33,712評(píng)論 4 323
  • 正文 年R本政府宣布北秽,位于F島的核電站葡幸,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏贺氓。R本人自食惡果不足惜蔚叨,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,261評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望辙培。 院中可真熱鬧蔑水,春花似錦、人聲如沸扬蕊。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,264評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽尾抑。三九已至歇父,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間蛮穿,已是汗流浹背庶骄。 一陣腳步聲響...
    開封第一講書人閱讀 31,486評(píng)論 1 262
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留践磅,地道東北人单刁。 一個(gè)月前我還...
    沈念sama閱讀 45,511評(píng)論 2 354
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像府适,于是被迫代替她去往敵國(guó)和親羔飞。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,802評(píng)論 2 345

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

  • 前言 初學(xué)markdown檐春,看了一些指南逻淌,第一次在簡(jiǎn)書上用markdown做的一個(gè)總結(jié),大部分為摘抄與精簡(jiǎn)疟暖,主要是...
    Yolanda__WU閱讀 953評(píng)論 0 0
  • atom編輯器的使用和markdown基本語法 atom介紹 atom是什么 Atom是github內(nèi)部的編輯軟件...
    Haoqian閱讀 35,507評(píng)論 3 39
  • 在Markdown中寫東西卡儒,是非常令人興奮的田柔,因?yàn)樗?jiǎn)單易用的特性還有簡(jiǎn)潔的語法給人條理清晰的既視感。以下是Mar...
    夏醬醬閱讀 962評(píng)論 0 2
  • ??markdown是一種輕量級(jí)標(biāo)記語言骨望,具有純文本格式語法硬爆。它由John Gruber 與Aaron Swart...
    淺羨閱讀 16,987評(píng)論 2 8
  • 主要內(nèi)容 Markdown是什么?誰創(chuàng)造了它擎鸠?為什么要使用它缀磕?怎么使用?誰在用劣光?嘗試一下 正文 1. Markdo...
    大大大大槐樹閱讀 446評(píng)論 0 0