Markdown 語(yǔ)法快速入門(mén)手冊(cè)

2025-02-28 11:57 更新
  • Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言,能將文本換成有效的 XHTML(或者 HTML)文檔,它的目標(biāo)是實(shí)現(xiàn)易讀易寫(xiě),成為一種適用于網(wǎng)絡(luò)的書(shū)寫(xiě)語(yǔ)言。
  • Markdown 語(yǔ)法簡(jiǎn)潔明了,易于掌握,所以用它來(lái)寫(xiě)作是件既效率又舒服的事情。我們所熟知的和一些大型 CMS,如 Joomla!、Drupal 等都能很好的支持 Markdown。我是因?yàn)閷?xiě)GitHub項(xiàng)目庫(kù)中的 Readme 才開(kāi)始接觸 Markdown。
  • Markdown 不是想要取代 HTML,甚至也沒(méi)有要和它相近,它的語(yǔ)法種類(lèi)很少,只對(duì)應(yīng) HTML 標(biāo)記的一小部分。
  • Markdown 的構(gòu)想不是要使得 HTML 文檔更容易書(shū)寫(xiě)。在我看來(lái), HTML 已經(jīng)很容易寫(xiě)了。
  • Markdown 的理念是,能讓文檔更容易讀、寫(xiě)和隨意改。
  • HTML 是一種發(fā)布的格式,Markdown 是一種書(shū)寫(xiě)的格式。
  • 就這樣,Markdown 的格式語(yǔ)法只涵蓋純文本可以涵蓋的范圍。

Headers 標(biāo)題:


#  H1
##  H2
###  H3
####  H4
#####  H5
######  H6

另外,H1 和 H2 還能用以下方式顯示:


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

Emphasis 文本強(qiáng)調(diào):


*斜體* or _強(qiáng)調(diào)_
**加粗** or __加粗__
***粗斜體*** or ___粗斜體__

但是,如果你的*_兩邊都有空白的話(huà),它們就只會(huì)被當(dāng)成普通的符號(hào):這是一段*文本強(qiáng)調(diào)*的說(shuō)明示例。

如果要在文字前后直接插入普通的星號(hào)或底線(xiàn),你可以用反斜線(xiàn)(轉(zhuǎn)義符):\*這是一段被星號(hào)包圍的文字\*

Lists 列表:


Unordered 無(wú)序列表:


* 無(wú)序列表
* 子項(xiàng)
* 子項(xiàng)
 
+ 無(wú)序列表
+ 子項(xiàng)
+ 子項(xiàng)
 
- 無(wú)序列表
- 子項(xiàng)
- 子項(xiàng)

Ordered 有序列表:


1. 第一行
2. 第二行
3. 第三行
 
1. 第一行
- 第二行
- 第三行

組合:


* 產(chǎn)品介紹(子項(xiàng)無(wú)項(xiàng)目符號(hào))
    此時(shí)子項(xiàng),要以一個(gè)制表符或者4個(gè)空格縮進(jìn)
 
* 產(chǎn)品特點(diǎn)
    1. 特點(diǎn)1
    - 特點(diǎn)2
    - 特點(diǎn)3
* 產(chǎn)品功能
    1. 功能1
    - 功能2
    - 功能3
 

可有時(shí)我們會(huì)出現(xiàn)這樣的情況,首行內(nèi)容是以日期或數(shù)字開(kāi)頭:2017. 公司年度目標(biāo)。

為了避免也被轉(zhuǎn)化成有序列表,我們可以在"."前加上反斜杠(轉(zhuǎn)義符):2017\. 公司年度目標(biāo)。

Links 連接(title為可選項(xiàng)):


Inline-style 內(nèi)嵌方式:

[W3Cschool](http://m.o2fo.com/ "W3Cschool")

Reference-style 引用方式:

[鏈接文字][id]
[id]: http://m.o2fo.com/ "標(biāo)題文字"

Relative reference to a repository file 引用存儲(chǔ)文件:

[鏈接文字](../path/file/readme.text "標(biāo)題文字")

還能這樣使用:

[鏈接文字][]
[鏈接文字]: http://m.o2fo.com/

Email 郵件:

<example@w3cschool.cn>

Images 圖片:


Inline-style 內(nèi)嵌方式:

![替代文字](http://statics.w3cschool.cn/images/w3c/index-logo.png "標(biāo)題文字")

Reference-style 引用方式:

![替代文字][logo]
[logo]: http://statics.w3cschool.cn/images/w3c/index-logo.png "標(biāo)題文字"

Code and Syntax Highlighting 代碼和語(yǔ)法高亮:


標(biāo)記一小段行內(nèi)代碼:

本文是一篇介紹`Markdown`的語(yǔ)法的文章

如果高亮的內(nèi)容包含`號(hào),可以這樣寫(xiě):

`` `包裹起來(lái)` ``

語(yǔ)法高亮:

```html
    <div>語(yǔ)法高亮顯示</div>
```
```css
    body{font-size:12px}
```
```javascript
    var s = "JavaScript語(yǔ)法高亮顯示";
alert(s); ```
```php
    <?php
      echo "你好,編程獅!";
    ?>
```
```python
    s = "Python 語(yǔ)法高亮"
    print s
```

Block Code 代碼分組(代碼區(qū)塊):


在該行開(kāi)頭縮進(jìn)4個(gè)空格或一個(gè)制表符(tab)

Blockquotes 引用:

> 電子郵件風(fēng)格尖括號(hào)
> 用于區(qū)塊報(bào)價(jià)。
> > 而且,它們可以嵌套。
> #### 區(qū)塊引號(hào)中的標(biāo)題
> * 你可以引用一個(gè)列表。
> * 等等。


Hard Line Breaks 換行:


在一行的結(jié)尾處加上2個(gè)或2個(gè)以上的空格,也可以使用</br>標(biāo)簽
第一行文字,
第二行文字

Horizontal Rules 水平分割線(xiàn):


***
* * *
- - -

Escape character 轉(zhuǎn)義符(反斜杠):


Markdown 可以利用反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào),例如:如果你想要用星號(hào)加在文字旁邊的方式來(lái)做出強(qiáng)調(diào)效果,你可以在星號(hào)的前面加上反斜杠:

\*字面星號(hào)\*

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

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

Additional 補(bǔ)充:

Markdown 也支持傳統(tǒng)的 HTML 標(biāo)簽。

比如一個(gè)鏈接,你不太喜歡 Markdown 的寫(xiě)法,也可以直接寫(xiě)成


<a href="http://m.o2fo.com/">W3Cschool</a>



Markdown在線(xiàn)編輯器:


以上內(nèi)容是否對(duì)您有幫助:
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)