學習筆記【Markdown】

Markdown簡明學習筆記


Markdown簡介

Markdown是一種輕量級標記語言,創(chuàng)始人為約翰·格魯伯(英語:John Gruber)礁竞。它允許人們“使用易讀易寫的純文本格式編寫文檔糖荒,然后轉換成有效的XHTML(或者HTML)文檔”。[4]這種語言吸收了很多在電子郵件中已有的純文本標記的特性苏章。

John Gruber 在 2004 年創(chuàng)造了 Markdown 語言寂嘉,在語法上有很大一部分是跟亞倫·斯沃茨(Aaron Swartz)共同合作的。這個語言的目的是希望大家使用“易于閱讀枫绅、易于撰寫的純文字格式泉孩,并選擇性的轉換成有效的XHTML(或是HTML)”。 其中最重要的設計是可讀性并淋,也就是說這個語言應該要能直接在字面上的被閱讀寓搬,而不用被一些格式化指令標記(像是RTF與HTML)。 因此县耽,它是現(xiàn)行電子郵件標記格式的慣例句喷,雖然它也借鑒了很多早期的標記語言,如:Setext兔毙、Texile唾琼、reStructuredText。 許多網(wǎng)站都使用 Markdown 或是其變種讓用戶更利于討論澎剥。例如:GitHub锡溯、reddit、Diaspora哑姚、Stack Exchange祭饭、OpenStreetMap 、SourceForge等叙量。


Markdown語法

id name sex
1 A1 B1
2 A2 B2
3 A3 B3

1. 標題

標題是每篇文章必備而且最常用的格式倡蝙。

在Markdown中,如果想將一段文字定義為標題绞佩,只需要在這段文字前面加上 #寺鸥,再在 # 后加一個空格即可。還可增加二品山、三析既、四、五谆奥、六級標題眼坏,總共六級,只需要增加 # ,增加一個 # 宰译,標題字號相應降低一級檐蚜。

2-0-標題.png

2. 列表

列表格式也很常用,它可以讓你的文稿變得井井有條沿侈。在 Markdown 中闯第,你只需要在文字前面加上 - 就可以了;如果你希望是有序列表缀拭,在文字前面加上 1. 2. 3. 即可咳短。

注:-、1.和文字之間要保留一個字符的空格蛛淋。

2-1-列表.png

3. 引用

記錄

如果你需要在文稿中引用一段別處的句子咙好,那么就要用到「引用」格式。

在引用文字前加上 > 并與文字保留一個字符的空格褐荷,即可勾效。


2-2引用.png

區(qū)塊引用可以嵌套(例如:引用內的引用),只要根據(jù)層次加上不同數(shù)量的 > :

This is the first level of quoting.

This is nested blockquote.

Back to the first level.
引用的區(qū)塊內也可以使用其他的 Markdown 語法叛甫,包括標題层宫、列表、代碼區(qū)塊等:

這是一個標題其监。

  1. 這是第一行列表項萌腿。
  2. 這是第二行列表項。

給出一些例子代碼:

return shell_exec("echo $input | $markdown_script");

建立代碼區(qū)塊很簡單抖苦,只要簡單地縮進 4 個空格或是 1 個制表符就可以

這是一個普通段落:

這是一個代碼區(qū)塊哮奇。

4. 粗體和斜體

Markdown 的粗體和斜體也非常簡單:

用兩個 * 包含一段文本就是粗體的語法;

用一個 * 包含一段文本就是斜體的語法

2-3-粗體斜體.png

5. 鏈接與圖片

鏈接:在 Markdown 中睛约,插入鏈接只需要使用 顯示文本 即可。

圖片:在 Markdown 中哲身,插入圖片只需要使用 [圖片上傳失敗...(image-b99d23-1528167562947)]即可辩涝。

注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 勘天!

2-4鏈接與圖片.png

6. 分割線

分割線的語法只需要另起一行,連續(xù)輸入三個星號 *** 即可分割兩段文字內容。

如圖:
2-5-分割線.png

7. 表格

id name sex
1 A1 B1
2 A2 B2
3 A3 B3

注意表格橫線的冒號----:蛛芥,此表示是否居中饶囚。
|---|和|:--|都表示左對齊
|:--:|表示居中對齊
|--"|表示右對齊

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

當你需要在Markdown文稿中鍵入表格,代碼如下:


2-6表格.png

8. 代碼區(qū)塊

建立代碼區(qū)塊很簡單宠进,只要簡單地縮進 4 個空格或是 1 個制表符就可以

這是一個普通段落:

這是一個代碼區(qū)塊晕拆。
12

一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結尾)。


9. 鏈接

Markdown 支持兩種形式的鏈接語法: 行內式和參考式兩種形式材蹬。

不管是哪一種实幕,鏈接文字都是用 [方括號] 來標記吝镣。

要建立一個行內式的鏈接,只要在方塊括號后面緊接著圓括號并插入網(wǎng)址鏈接即可昆庇,如果你還想要加上鏈接的 title 文字末贾,只要在網(wǎng)址后面,用雙引號把 title 文字包起來即可
This is an example inline link.
This link has no title attribute.

image.png

10. 腳注

注腳[^6][[6]]8
使用 [^keyword] 表示注腳整吆。
備注:關于注腳好像每個編輯器表示方式會有所不同拱撵。


11.待辦事宜 Todo 列表

使用帶有 [ ] 或 [x] (未完成或已完成)項的列表語法撰寫一個待辦事宜列表例如:

/ - []things


12. 流程圖


支持Markdown語法的軟件或網(wǎng)站

  • Apollo 使用Markdown格式化[8]

  • Bitbucket 提供Markdown作為編寫項目README文檔的其中一種標記語言。[9]

  • DIASPORA* 使用Markdown格式化用戶發(fā)送的消息表蝙、評論和對話拴测。[10]

  • Drupal 是一個Markdown插件[11],始創(chuàng)于2008年勇哗。截止2011年11月昼扛,已有8000個建站軟件使用了該插件。

  • Ghost 使用Markdown的一個標準版本編輯器來格式化撰寫的文章欲诺。[12]

  • GitHub 使用Markdown的一個分支版本(稱為GitHub Flavored Markdown)來格式化評論抄谐、消息以及其它內容。[13][14] John Gruber has described this dialect as a "superior variant" for "situations like user-submitted comments".[15]

  • G+ Tweaks v1.1151扰法,一個適用于 Google+Greasemonkey 用戶腳本蛹含。[16]

  • Instiki uses a Markdown extension to wiki syntax. The extended syntax is called Maruku.[17]

  • Moodle 提供 Markdown 作為語法標記語言。[18]

  • Posterous 提供 Markdown 作為語法標記語言塞颁。[19]

  • Reddit 的編輯器使用了 Markdown 語法浦箱。[20]

  • Showoff 使用 Markdown 作為提交的語法。[21]

  • Squarespace 在博客界面下提供 Markdown 編輯器祠锣。[22]

  • Stack Overflow 以及其他 Stack Exchange Network 網(wǎng)站使用一種 Markdown 的分支作為它的文章格式化系統(tǒng)酷窥。[23][24]

  • Tumblr 允許在文章中使用 Markdown。[25]

  • Typecho 原生支持Markdown編輯器伴网,實時預覽. [26]

  • The WordPress plugin system utilizes a dialect of Markdown in "readme.txt" files submitted by developers, and has plugins for Markdown.[27]

  • Second Gear's Elements app for iPhone and iPad gained Markdown capability with its v2 around November of 2010.[28]

  • 圖靈社區(qū) 使用markdown語法供用戶寫作電子書.

  • 簡書 寫作網(wǎng)站蓬推,支持 Markdown

  • 為知筆記 是一種類似 印象筆記 的筆記軟件,支持使用Markdown語法編輯筆記

  • HackMD是一個支持Markdown的在線語法編輯筆記網(wǎng)站澡腾,可即時切換源代碼與成果查看沸伏。

  • 純純寫作 是一種支持使用Markdown語法編輯文本的輕量級文本編輯軟件

  • 有道云筆記在2016年也開始支持使用markdown來記錄

  • 簡書也開始支持使用markdown來記錄

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市动分,隨后出現(xiàn)的幾起案子毅糟,更是在濱河造成了極大的恐慌,老刑警劉巖澜公,帶你破解...
    沈念sama閱讀 222,104評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件姆另,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機蜕青,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,816評論 3 399
  • 文/潘曉璐 我一進店門苟蹈,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人右核,你說我怎么就攤上這事慧脱。” “怎么了贺喝?”我有些...
    開封第一講書人閱讀 168,697評論 0 360
  • 文/不壞的土叔 我叫張陵菱鸥,是天一觀的道長。 經(jīng)常有香客問我躏鱼,道長氮采,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 59,836評論 1 298
  • 正文 為了忘掉前任染苛,我火速辦了婚禮鹊漠,結果婚禮上,老公的妹妹穿的比我還像新娘茶行。我一直安慰自己躯概,他們只是感情好,可當我...
    茶點故事閱讀 68,851評論 6 397
  • 文/花漫 我一把揭開白布畔师。 她就那樣靜靜地躺著娶靡,像睡著了一般。 火紅的嫁衣襯著肌膚如雪看锉。 梳的紋絲不亂的頭發(fā)上姿锭,一...
    開封第一講書人閱讀 52,441評論 1 310
  • 那天,我揣著相機與錄音伯铣,去河邊找鬼呻此。 笑死,一個胖子當著我的面吹牛腔寡,可吹牛的內容都是我干的焚鲜。 我是一名探鬼主播,決...
    沈念sama閱讀 40,992評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼蹬蚁,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了郑兴?” 一聲冷哼從身側響起犀斋,我...
    開封第一講書人閱讀 39,899評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎情连,沒想到半個月后叽粹,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,457評論 1 318
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 38,529評論 3 341
  • 正文 我和宋清朗相戀三年虫几,在試婚紗的時候發(fā)現(xiàn)自己被綠了锤灿。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 40,664評論 1 352
  • 序言:一個原本活蹦亂跳的男人離奇死亡辆脸,死狀恐怖但校,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情啡氢,我是刑警寧澤状囱,帶...
    沈念sama閱讀 36,346評論 5 350
  • 正文 年R本政府宣布,位于F島的核電站倘是,受9級特大地震影響亭枷,放射性物質發(fā)生泄漏。R本人自食惡果不足惜搀崭,卻給世界環(huán)境...
    茶點故事閱讀 42,025評論 3 334
  • 文/蒙蒙 一叨粘、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧瘤睹,春花似錦升敲、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,511評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至绸吸,卻和暖如春鼻弧,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背锦茁。 一陣腳步聲響...
    開封第一講書人閱讀 33,611評論 1 272
  • 我被黑心中介騙來泰國打工攘轩, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人码俩。 一個月前我還...
    沈念sama閱讀 49,081評論 3 377
  • 正文 我出身青樓度帮,卻偏偏與公主長得像,于是被迫代替她去往敵國和親稿存。 傳聞我的和親對象是個殘疾皇子笨篷,可洞房花燭夜當晚...
    茶點故事閱讀 45,675評論 2 359

推薦閱讀更多精彩內容