Markdown 語法快速入門手冊(cè)

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

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ì)被當(dāng)成普通的符號(hào):這是一段*文本強(qiáng)調(diào)*的說明示例。

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

Lists 列表:


Unordered 無序列表:


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

Ordered 有序列表:


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

組合:


* 產(chǎn)品介紹(子項(xiàng)無項(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ù)字開頭:2017. 公司年度目標(biāo)。

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

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


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

[W3Cschool](http://m.hgci.cn/ "W3Cschool")

Reference-style 引用方式:

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

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

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

還能這樣使用:

[鏈接文字][]
[鏈接文字]: http://m.hgci.cn/

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 代碼和語法高亮:


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


本文是一篇介紹`Markdown`的語法的文章

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

`` `包裹起來` ``

語法高亮:

```html
    <div>Syntax Highlighting</div>
```
```css
    body{font-size:12px}
```
```javascript
    var s = "JavaScript syntax highlighting";
    alert(s);
```
```php
    <?php
      echo "hello, world!";
    ?>
```
```python
    s = "Python syntax highlighting"
    print s
```

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


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

Blockquotes 引用:

> Email-style angle brackets
> are used for blockquotes.
> > And, they can be nested.
> #### Headers in blockquotes
> * You can quote a list.
> * Etc.


Hard Line Breaks 換行:


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

Horizontal Rules 水平分割線:


***
* * *
- - -

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


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

\*literal asterisks\*

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

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

Additional 補(bǔ)充:

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

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


<a href="http://m.hgci.cn/">W3Cschool</a>



Markdown官網(wǎng):http://daringfireball.net/projects/markdown/
參考資料:http://markdown.tw/

Markdown在線編輯器:



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

掃描二維碼

下載編程獅App

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

編程獅公眾號(hào)