Markdown通用的常用語(yǔ)法說(shuō)明

markdown-logo

前言

Markdown 是一種輕量級(jí)的 標(biāo)記語(yǔ)言,語(yǔ)法簡(jiǎn)潔明了、學(xué)習(xí)容易,還具有其他很多優(yōu)點(diǎn),目前被越來(lái)越多的人用來(lái)寫作使用。

Markdown具有一系列衍生版本,用于擴(kuò)展Markdown的功能(如表格、腳注、內(nèi)嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉(zhuǎn)換成更多的格式,例如LaTeX,Docbook。Markdown增強(qiáng)版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要么基于工具,如Pandoc;要么基于網(wǎng)站,如GitHub和Wikipedia,在語(yǔ)法上基本兼容,但在一些語(yǔ)法和渲染效果上有改動(dòng)。

由于一些擴(kuò)展只在特定的環(huán)境中才能實(shí)現(xiàn),所以這里介紹的是通用的常用語(yǔ)法說(shuō)明。

語(yǔ)法

下面就是常用的Markdown語(yǔ)法內(nèi)容,以標(biāo)準(zhǔn)Markdown語(yǔ)法為依據(jù),可能這里有一些差異,請(qǐng)以語(yǔ)法為準(zhǔn)。

標(biāo)題

標(biāo)題分為6級(jí),對(duì)應(yīng)HTML標(biāo)簽的h1~h6。#越多,字體越小。

# H1標(biāo)題
## H2標(biāo)題
### H3標(biāo)題
#### H4標(biāo)題
##### H5標(biāo)題
###### H6標(biāo)題

H1標(biāo)題

H2標(biāo)題

H3標(biāo)題

H4標(biāo)題

H5標(biāo)題
H6標(biāo)題

分隔符

分隔符就是一條橫線。

---

文本樣式

斜體

* 斜體文本 *
_ 斜體文本 _

斜體文本 斜體文本

粗體

加粗就是是文字為粗體顯示,可以使用下面兩中方式表示:

**粗體文本**
__粗體文本__

粗體文本

粗體文本

斜粗體

***斜粗體文本*** *__斜粗體文本__*
_**斜粗體文本**_ ___斜粗體文本___

斜粗體文本 斜粗體文本

斜粗體文本 斜粗體文本

刪除線

文字有一條刪除線的效果

~~ 刪除效果 ~~

刪除效果

高亮

文字用醒目的高亮顯示

這是` 高亮文本 `效果。

這是高亮文本效果。

代碼塊

代碼塊就是將源碼直接進(jìn)行展示,可在開始的** ``` **后面加上代碼語(yǔ)種名稱。

`` `  javascript
var str = "hello world!";
alert(str);
`` `

為了顯示,上面給出的```加了一個(gè)空格。

var str = "hello world!";
alert(str);

上面就是效果

圖片

圖片展示

方式1:
![文本內(nèi)容](https://help.github.com/assets/images/site/favicon.ico "logo")
方式2:
![文本內(nèi)容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"

方式1:

文本內(nèi)容
文本內(nèi)容

方式2:
![文本內(nèi)容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"

<h6 id="url-more">說(shuō)明:</h6>

URL后面的內(nèi)容是鼠標(biāo)hover提示文本,可以省略,省略時(shí)就沒(méi)有鼠標(biāo)hover提示文本效果。

推薦使用方式2,當(dāng)一個(gè)鏈接在文中多次出現(xiàn)的時(shí)候,就會(huì)體現(xiàn)出其優(yōu)點(diǎn)了。

另外,后面的提示文本除了使用 "提示文本" 外,還可以是 '提示文本'(提示文本) 。

[id]:URL "鼠標(biāo)hover提示文本"
[id]:URL '鼠標(biāo)hover提示文本'
[id]:URL (鼠標(biāo)hover提示文本)

鏈接

鏈接根據(jù)鏈接目標(biāo)可分為站內(nèi)站外鏈接,按照類型可分為文本鏈接和圖片鏈接。
綜上所述,可分為以下三種:

文本鏈接

給文本信息添加超鏈接

1.<https://github.com/SeayXu>
2.[文本鏈接](https://github.com/SeayXu "SeayXu")
3.[文本鏈接][id]
[id]:https://github.com/SeayXu "SeayXu"

1.https://github.com/SeayXu
2.文本鏈接
3.[文本鏈接][id]
[id]:https://github.com/SeayXu "SeayXu"

鏈接URL相關(guān)說(shuō)明和圖片一樣,請(qǐng)查看

特例:
當(dāng)鏈接的文本內(nèi)容和鏈接Id相同的時(shí)候,可以不用寫鏈接后面的Id。

[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"

[SeayXu][]
[SeayXu]: https://github.com/SeayXu "Seay"

圖片鏈接

給圖片加上超鏈接

方式1:
[![Github](https://help.github.com/assets/images/site/favicon.ico "Seay")](https://github.com/SeayXu  "SeayXu")
方式2:
[![Github][img-url]][link-url]
[link-url]:https://github.com/SeayXu "SeayXu"
[img-url]:https://help.github.com/assets/images/site/favicon.ico "Seay"

方式1:


方式2:
![Github][github-img]

提示:由于各個(gè)Markdown解析不同,所以顯示的提示文本有可能也不太一樣。

錨點(diǎn)

錨點(diǎn)其實(shí)與文本鏈接和圖片鏈接用法是一樣的,只不過(guò)是在本頁(yè)面內(nèi),需要稍微改動(dòng)下。

設(shè)置錨點(diǎn)鏈接目標(biāo):

<h6 id="url-more">說(shuō)明:</h6>

添加錨點(diǎn):

[錨點(diǎn)](#url-more "anchor alt text")
[錨點(diǎn)][anchor]
[anchor]:#url-more "anchor alt text"

錨點(diǎn)
[錨點(diǎn)][anchor]
[anchor]:#url-more "anchor alt text"

說(shuō)明:相對(duì)于文本鏈接和圖片鏈接,主要是添加了錨點(diǎn)鏈接目標(biāo)這一操作,使用語(yǔ)法跟文本鏈接和圖片鏈接一樣。

列表

列表分為有序和無(wú)序兩種。

無(wú)序列表

無(wú)序列表有三種表示方法:* 、 +-

下級(jí)在上級(jí)基礎(chǔ)上前面多加兩個(gè)空格,符號(hào)與內(nèi)容直接有一個(gè)空格。

無(wú)序列表1:

* 一級(jí)條目1
* 一級(jí)條目2
  * 二級(jí)條目1
  * 二級(jí)條目2
    * 三級(jí)條目1
    * 三級(jí)條目2
    * 三級(jí)條目3
  * 二級(jí)條目3
* 一級(jí)條目3
  • 一級(jí)條目1
  • 一級(jí)條目2
    • 二級(jí)條目1
    • 二級(jí)條目2
      • 三級(jí)條目1
      • 三級(jí)條目2
      • 三級(jí)條目3
    • 二級(jí)條目3
  • 一級(jí)條目3

在這里只演示一種,另外兩種就是把 * 分別換成 +- 。

有序列表

有序列表與無(wú)序列表類似,只不是是將前面的符號(hào)換成數(shù)字而已。

1. 一級(jí)條目1
2. 一級(jí)條目2
  1. 二級(jí)條目1
  * 二級(jí)條目2
    * 三級(jí)條目1
    + 三級(jí)條目2
    - 三級(jí)條目3
  - 二級(jí)條目3
2. 一級(jí)條目3
  1. 一級(jí)條目1
  2. 一級(jí)條目2
  3. 二級(jí)條目1
  • 二級(jí)條目2
    • 三級(jí)條目1
    • 三級(jí)條目2
    • 三級(jí)條目3
  • 二級(jí)條目3
  1. 一級(jí)條目3

說(shuō)明:

  1. 有序列表有自動(dòng)糾錯(cuò)功能,當(dāng)序號(hào)輸入錯(cuò)誤時(shí),會(huì)自動(dòng)更正顯示序號(hào)。
  2. 有序列表可結(jié)合無(wú)序列表,只在第一個(gè)條目輸入序號(hào)后,同級(jí)條目會(huì)自動(dòng)編號(hào)。

引用

引用內(nèi)容可以嵌套引用和使用其他語(yǔ)法,在引用內(nèi)容后面空一行就表示引用結(jié)束。

>這是一段包含**加粗**的 _斜體_ 和 _**斜粗體**_ 并帶有`高亮`顯示的一段文本來(lái)自[我的Github](https://github.com/SeayXu "SeayXu")。
我是圖片:
![github logo][github-img]
[github-url]:https://github.com/SeayXu "SeayXu"

這是一段包含加粗斜體斜粗體 并帶有高亮顯示的一段文本來(lái)自我的Github。
我是圖片:

github logo
github logo

本文來(lái)自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處,可隨時(shí)與我聯(lián)系。

最后編輯于
?著作權(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)容

  • 標(biāo)題 標(biāo)題分為6級(jí),對(duì)應(yīng)HTML標(biāo)簽的h1~h6。#越多,字體越小。#H1標(biāo)題## H2標(biāo)題### H3標(biāo)題###...
    瘋范兒閱讀 478評(píng)論 0 0
  • Markdown是一種輕量級(jí)的[標(biāo)記語(yǔ)言],它的優(yōu)點(diǎn)很多,目前也被越來(lái)越多的寫作愛好者,撰稿者廣泛使用??吹竭@里請(qǐng)...
    李阿昀閱讀 19,175評(píng)論 1 18
  • 1. 斜體和粗體 代碼: 顯示效果: 這是一段斜體 這是一段粗體 這是一段加粗斜體 這是一段刪除線 2. 分級(jí)標(biāo)題...
    泊牧閱讀 2,496評(píng)論 0 2
  • 人生 總在經(jīng)受歲月的磨折之后 方至懂得了珍惜身邊的人 比你快樂(lè) 人生 總在經(jīng)受風(fēng)雨的洗禮 方至懂得你所希望的我 是...
    小草_d5ad閱讀 493評(píng)論 21 50
  • 欣賞好的,但不指望未來(lái)都是好的。
    乞力馬扎羅的咸魚閱讀 425評(píng)論 0 1

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