Markdown語(yǔ)法

轉(zhuǎn)載于:http://sidney001.top/2016/11/17/Markdown語(yǔ)法/

主要內(nèi)容

Markdown是什么?

為什么要使用它?

怎么使用?

誰(shuí)在用?####

感覺有意思?不怕你看見,就怕你試試

正文

1. Markdown是什么?

Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言,它以純文本形式(易讀、易寫、易更改)編寫文檔,并最終以HTML格式發(fā)布。
Markdown也可以理解為將以MARKDOWN語(yǔ)言編寫的語(yǔ)言轉(zhuǎn)換成HTML內(nèi)容的工具,最初是一個(gè)perl腳本Markdown.pl。

2. 為什么要使用它?

  • 它是易讀(看起開舒服)、易寫(語(yǔ)法簡(jiǎn)單)、易更改純文本。處處體現(xiàn)著極簡(jiǎn)主義的影子。
  • 兼容HTML,可以轉(zhuǎn)換為HTML格式發(fā)布。
  • 跨平臺(tái)使用。
  • 越來越多的網(wǎng)站支持Markdown。
  • 更方便清晰的組織你的電子郵件。(Markdown-here, Airmail)
  • 擺脫Word(我不是認(rèn)真的)。

3. 怎么使用?

如果不算擴(kuò)展,Markdown的語(yǔ)法絕對(duì)簡(jiǎn)單到讓你愛不釋手。

廢話太多,下面正文,Markdown語(yǔ)法主要分為如下幾大部分:
標(biāo)題,段落區(qū)塊引用,代碼區(qū)塊,強(qiáng)調(diào),列表,分割線鏈接,圖片反斜杠 \符號(hào)'`'

3.1 標(biāo)題

兩種形式:
1)使用=-標(biāo)記一級(jí)和二級(jí)標(biāo)題。

一級(jí)標(biāo)題
=========
二級(jí)標(biāo)題
---------

效果:

一級(jí)標(biāo)題

二級(jí)標(biāo)題

2)使用#,可表示1-6級(jí)標(biāo)題。

# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題

效果:

一級(jí)標(biāo)題

二級(jí)標(biāo)題

三級(jí)標(biāo)題

四級(jí)標(biāo)題

五級(jí)標(biāo)題
六級(jí)標(biāo)題

3.2 段落

段落的前后要有空行,所謂的空行是指沒有文字內(nèi)容。若想在段內(nèi)強(qiáng)制換行的方式是使用兩個(gè)以上空格加上回車(引用中換行省略回車)。

3.3 區(qū)塊引用

在段落的每行或者只在第一行使用符號(hào)>,還可使用多個(gè)嵌套引用,如:

> 區(qū)塊引用
>> 嵌套引用

效果:

區(qū)塊引用

嵌套引用

3.4 代碼區(qū)塊

代碼區(qū)塊的建立是在每行加上4個(gè)空格或者一個(gè)制表符(如同寫代碼一樣)。如
普通段落:

void main()
{
printf("Hello, Markdown.");
}

代碼區(qū)塊:

void main()
{
    printf("Hello, Markdown.");
}

注意:需要和普通段落之間存在空行。

3.5 強(qiáng)調(diào)

在強(qiáng)調(diào)內(nèi)容兩側(cè)分別加上*或者_,如:

*斜體*,_斜體_
**粗體**,__粗體__

效果:

斜體,斜體
粗體粗體

3.6 列表

使用·+、或-標(biāo)記無(wú)序列表,如:

-(+*) 第一項(xiàng)
-(+*) 第二項(xiàng)
- (+*)第三項(xiàng)

注意:標(biāo)記后面最少有一個(gè)空格制表符。若不在引用區(qū)塊中,必須和前方段落之間存在空行。

效果:

  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)

有序列表的標(biāo)記方式是將上述的符號(hào)換成數(shù)字,并輔以.,如:

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

效果:

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

3.7 分割線

分割線最常使用就是三個(gè)或以上*,還可以使用-_。

3.8 鏈接

鏈接可以由兩種形式生成:行內(nèi)式參考式
行內(nèi)式

[younghz的Markdown庫(kù)](https:://github.com/younghz/Markdown "Markdown")。

效果:

younghz的Markdown庫(kù)

參考式

[younghz的Markdown庫(kù)1][1]
[younghz的Markdown庫(kù)2][2]
[1]:https:://github.com/younghz/Markdown "Markdown"
[2]:https:://github.com/younghz/Markdown "Markdown"

效果:

younghz的Markdown庫(kù)1
younghz的Markdown庫(kù)2

注意:上述的[1]:https:://github.com/younghz/Markdown "Markdown"不出現(xiàn)在區(qū)塊中。

3.9 圖片

添加圖片的形式和鏈接相似,只需在鏈接的基礎(chǔ)上前方加一個(gè)!。

3.10 反斜杠\

相當(dāng)于反轉(zhuǎn)義作用。使符號(hào)成為普通符號(hào)。

3.11 符號(hào)'`'

起到標(biāo)記作用。如:

`ctrl+a`

效果:

ctrl+a

4. 都誰(shuí)在用?####

Markdown的使用者:

  • GitHub
  • 簡(jiǎn)書
  • Stack Overflow
  • Apollo
  • Moodle
  • Reddit
  • 等等

5. 感覺有意思?趁熱打鐵,推薦幾個(gè)工具。

  • Chrome下的stackedit插件可以離線使用,很爽。也不用擔(dān)心平臺(tái)受限。
    在線的dillinger.io算是評(píng)價(jià)好的了,可是不能離線使用。
  • Windowns下的MarkdownPad也用過,不過免費(fèi)版的體驗(yàn)不是很好。
  • Mac下的Mou是國(guó)人貢獻(xiàn)的,口碑很好。推薦。
  • Linux下的ReText不錯(cuò)。

其實(shí)在對(duì)語(yǔ)法了如于心的話,直接用編輯器就可以了,腦子里滿滿的都是格式化好的文本啊。
我現(xiàn)在使用馬克飛象 + Markdown-here,先編輯好,然后一鍵格式化,挺方便。


注意:不同的Markdown解釋器或工具對(duì)相應(yīng)語(yǔ)法(擴(kuò)展語(yǔ)法)的解釋效果不盡相同,具體可參見工具的使用說明。
雖然有人想出面搞一個(gè)所謂的標(biāo)準(zhǔn)化的Markdown,[沒想到還惹怒了健在的創(chuàng)始人John Gruber]
(http://blog.codinghorror.com/standard-markdown-is-now-common-markdown/)。


以上基本是所有traditonal markdown的語(yǔ)法。

其它:

列表的使用(非traditonal markdown):

|表示表格縱向邊界,表頭和表內(nèi)容用-隔開,并可用:進(jìn)行對(duì)齊設(shè)置,兩邊都有:則表示居中,若不加:則默認(rèn)左對(duì)齊。

代碼庫(kù) 鏈接
MarkDown https://github.com/younghz/Markdown
moos-young https://github.com/younghz/moos-young

關(guān)于其它擴(kuò)展語(yǔ)法可參見具體工具的使用說明。

Modified based on :younghz's Github

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

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

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