學(xué)習(xí)筆記【Markdown】

Markdown簡明學(xué)習(xí)筆記


Markdown簡介

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

John Gruber 在 2004 年創(chuàng)造了 Markdown 語言,在語法上有很大一部分是跟亞倫·斯沃茨(Aaron Swartz)共同合作的。這個語言的目的是希望大家使用“易于閱讀、易于撰寫的純文字格式,并選擇性的轉(zhuǎn)換成有效的XHTML(或是HTML)”。 其中最重要的設(shè)計(jì)是可讀性,也就是說這個語言應(yīng)該要能直接在字面上的被閱讀,而不用被一些格式化指令標(biāo)記(像是RTF與HTML)。 因此,它是現(xiàn)行電子郵件標(biāo)記格式的慣例,雖然它也借鑒了很多早期的標(biāo)記語言,如: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. 標(biāo)題

標(biāo)題是每篇文章必備而且最常用的格式。

在Markdown中,如果想將一段文字定義為標(biāo)題,只需要在這段文字前面加上 #,再在 # 后加一個空格即可。還可增加二、三、四、五、六級標(biāo)題,總共六級,只需要增加 # ,增加一個 # ,標(biāo)題字號相應(yīng)降低一級。

2-0-標(biāo)題.png

2. 列表

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

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

2-1-列表.png

3. 引用

記錄

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

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


2-2引用.png

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

This is the first level of quoting.

This is nested blockquote.

Back to the first level.
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法,包括標(biāo)題、列表、代碼區(qū)塊等:

這是一個標(biāo)題。

  1. 這是第一行列表項(xiàng)。
  2. 這是第二行列表項(xiàng)。

給出一些例子代碼:

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

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

這是一個普通段落:

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

4. 粗體和斜體

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

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

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

2-3-粗體斜體.png

5. 鏈接與圖片

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

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

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

2-4鏈接與圖片.png

6. 分割線

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

如圖:
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

當(dāng)你需要在Markdown文稿中鍵入表格,代碼如下:


2-6表格.png

8. 代碼區(qū)塊

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

這是一個普通段落:

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

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


9. 鏈接

Markdown 支持兩種形式的鏈接語法: 行內(nèi)式和參考式兩種形式。

不管是哪一種,鏈接文字都是用 [方括號] 來標(biāo)記。

要建立一個行內(nèi)式的鏈接,只要在方塊括號后面緊接著圓括號并插入網(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] 表示注腳。
備注:關(guān)于注腳好像每個編輯器表示方式會有所不同。


11.待辦事宜 Todo 列表

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

/ - []things


12. 流程圖


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

  • Apollo 使用Markdown格式化[8]

  • Bitbucket 提供Markdown作為編寫項(xiàng)目README文檔的其中一種標(biāo)記語言。[9]

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

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

  • Ghost 使用Markdown的一個標(biāo)準(zhǔn)版本編輯器來格式化撰寫的文章。[12]

  • GitHub 使用Markdown的一個分支版本(稱為GitHub Flavored Markdown)來格式化評論、消息以及其它內(nèi)容。[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 作為語法標(biāo)記語言。[18]

  • Posterous 提供 Markdown 作為語法標(biāo)記語言。[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編輯器,實(shí)時(shí)預(yù)覽. [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)站,可即時(shí)切換源代碼與成果查看。

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

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

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容