2019-07-07 Markdown使用教程

1. 什么是Markdown?

Markdown 是一種非常簡單的冠桃、輕量級的標記語言。用戶可以使用簡單的標記符號以最小的輸入代價去生成極富表現(xiàn)力的文檔均践。Markdown 的語法簡潔明了、學(xué)習(xí)容易,功能比純文本強得多宋渔,因此有很多人用它寫博客、寫文檔辜限。

2. Markdown優(yōu)點

  • 易讀(看起來舒服)幕与、易寫(語法簡單)、易更改(純文本)龙填,可以方便地納入版本控制捡鱼;
  • 格式轉(zhuǎn)換方便,Markdown 的文本可以輕松轉(zhuǎn)換為 HTML毫深、PDF吩坝、Word、圖像哑蔫、Epub 等文件钉寝;
  • 語法簡單,沒有什么學(xué)習(xí)成本闸迷,能輕松在碼字的同時做出美觀大方的排版嵌纲。

3. 使用場景

  • 各類代碼托管平臺
    主流的代碼托管平臺,如 GitHub稿黍、GitLab疹瘦、BitBucket、Coding巡球、Gitee 等等言沐,都支持 Markdown 語法邓嘹,很多開源項目的 README、開發(fā)文檔险胰、幫助文檔汹押、Wiki 等都用 Markdown 寫作。

  • 技術(shù)社區(qū)和寫作平臺
    StackOverflow起便、CSDN棚贾、掘金、簡書榆综、GitBook妙痹、有道云筆記

  • 論壇
    V2EX、光谷社區(qū)

4. 如何使用Markdown

Markdown基礎(chǔ)語法主要包括以下內(nèi)容:
標題鼻疮、段落格式怯伊、列表、區(qū)塊判沟、代碼耿芹、鏈接、圖片挪哄、表格

4.1 標題

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

效果:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

4.2 段落格式

4.2.1 字體

斜體文本

粗體文本

粗斜體文本

4.2.2 分隔線

-------
*********

效果:



4.3 列表

4.3.1 有序列表

有序列表使用數(shù)字并加上 . 號來表示

1. 第一項
2. 第二項
3. 第三項

4.3.1 無序列表

無序列表使用星號(*)吧秕、加號(+)或是減號(-)作為列表標記

  • 第一項
  • 第二項
  • 第三項

4.4 區(qū)塊

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

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

4.5 代碼

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

``` 包裹一段代碼砸彬,并指定一種語言(也可以不指定):

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

4.6 鏈接

鏈接名稱
goole地址:google

4.7 圖片

開頭一個感嘆號 !
接著一個方括號,里面放上圖片的替代文字
接著一個普通括號疗涉,里面放上圖片的網(wǎng)址拿霉,最后還可以用引號包住并加上選擇性的 'title' 屬性的文字吟秩。

[圖片上傳失敗...(image-33f202-1563182632593)]

4.8 表格

使用 | 來分隔不同的單元格咱扣,使用 - 來分隔表頭和其他行。

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

還可以設(shè)置對齊方式:

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

5. 高級技巧

包括流程圖涵防,公式編輯器等

\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}

5. 編輯工具

理論上任何一款文本編輯器都能用于編輯 Markdown 文檔闹伪,它們分別提供了不同程度的語法高亮、預(yù)覽等功能壮池,以下只是列舉其中一部分偏瓤,選擇自己稱手的即可。

  • 現(xiàn)代編輯器
    VSCode / Atom

  • 傳統(tǒng)編輯器
    Vim / Emacs / Sublime Text / Notepad++

  • IDE 自帶編輯器
    IntelliJ IDEA / Android Studio / WebStorm

  • 專用編輯器
    Ulysses / Mou / Typora / Markpad

  • 在線編輯器
    各種支持 Markdown 的網(wǎng)站都提供了在線編輯器椰憋,CSDN厅克、簡書、有道云筆記等

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末橙依,一起剝皮案震驚了整個濱河市证舟,隨后出現(xiàn)的幾起案子硕旗,更是在濱河造成了極大的恐慌,老刑警劉巖女责,帶你破解...
    沈念sama閱讀 217,277評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件漆枚,死亡現(xiàn)場離奇詭異,居然都是意外死亡抵知,警方通過查閱死者的電腦和手機墙基,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,689評論 3 393
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來刷喜,“玉大人残制,你說我怎么就攤上這事∫创” “怎么了痘拆?”我有些...
    開封第一講書人閱讀 163,624評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長氮墨。 經(jīng)常有香客問我纺蛆,道長,這世上最難降的妖魔是什么规揪? 我笑而不...
    開封第一講書人閱讀 58,356評論 1 293
  • 正文 為了忘掉前任桥氏,我火速辦了婚禮,結(jié)果婚禮上猛铅,老公的妹妹穿的比我還像新娘字支。我一直安慰自己,他們只是感情好奸忽,可當我...
    茶點故事閱讀 67,402評論 6 392
  • 文/花漫 我一把揭開白布堕伪。 她就那樣靜靜地躺著,像睡著了一般栗菜。 火紅的嫁衣襯著肌膚如雪欠雌。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,292評論 1 301
  • 那天疙筹,我揣著相機與錄音富俄,去河邊找鬼。 笑死而咆,一個胖子當著我的面吹牛霍比,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播暴备,決...
    沈念sama閱讀 40,135評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼悠瞬,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起浅妆,我...
    開封第一講書人閱讀 38,992評論 0 275
  • 序言:老撾萬榮一對情侶失蹤玛痊,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后狂打,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體擂煞,經(jīng)...
    沈念sama閱讀 45,429評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,636評論 3 334
  • 正文 我和宋清朗相戀三年趴乡,在試婚紗的時候發(fā)現(xiàn)自己被綠了对省。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,785評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡晾捏,死狀恐怖蒿涎,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情惦辛,我是刑警寧澤劳秋,帶...
    沈念sama閱讀 35,492評論 5 345
  • 正文 年R本政府宣布,位于F島的核電站胖齐,受9級特大地震影響玻淑,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜呀伙,卻給世界環(huán)境...
    茶點故事閱讀 41,092評論 3 328
  • 文/蒙蒙 一补履、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧剿另,春花似錦箫锤、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,723評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至氛堕,卻和暖如春馏臭,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背岔擂。 一陣腳步聲響...
    開封第一講書人閱讀 32,858評論 1 269
  • 我被黑心中介騙來泰國打工位喂, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人乱灵。 一個月前我還...
    沈念sama閱讀 47,891評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像七冲,于是被迫代替她去往敵國和親痛倚。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,713評論 2 354

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