前言
Markdown 是一種輕量級的 標記語言,語法簡潔明了、學習容易,還具有其他很多優點,目前被越來越多的人用來寫作使用。
Markdown具有一系列衍生版本,用於擴展Markdown的功能(如表格、腳注、內嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉換成更多的格式,例如LaTeX,Docbook。Markdown增強版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要么基於工具,如Pandoc;要么基於網站,如GitHub和Wikipedia,在語法上基本兼容,但在一些語法和渲染效果上有改動。
由於一些擴展只在特定的環境中才能實現,所以這里介紹的是通用的常用語法說明。
語法
下面就是常用的Markdown語法內容,以標准Markdown語法為依據,可能這里有一些差異,請以語法為准。
標題
標題分為6級,對應HTML標簽的h1~h6。#越多,字體越小。
# H1標題
## H2標題
### H3標題
#### H4標題
##### H5標題
###### H6標題
H1標題
H2標題
H3標題
H4標題
H5標題
H6標題
分隔符
分隔符就是一條橫線。
---
文本樣式
斜體
* 斜體文本 *
_ 斜體文本 _
斜體文本 斜體文本
粗體
加粗就是是文字為粗體顯示,可以使用下面兩中方式表示:
**粗體文本**
__粗體文本__
粗體文本
粗體文本
斜粗體
***斜粗體文本*** *__斜粗體文本__*
_**斜粗體文本**_ ___斜粗體文本___
斜粗體文本 斜粗體文本
斜粗體文本 斜粗體文本
刪除線
文字有一條刪除線的效果
~~ 刪除效果 ~~
刪除效果
高亮
文字用醒目的高亮顯示
這是` 高亮文本 `效果。
這是高亮文本
效果。
代碼塊
代碼塊就是將源碼直接進行展示,可在開始的 ``` 后面加上代碼語種名稱。
`` ` javascript
var str = "hello world!";
alert(str);
`` `
為了顯示,上面給出的 ``` 加了一個空格。
var str = "hello world!";
alert(str);
上面就是效果
圖片
圖片展示
方式1:

方式2:
![文本內容][img]
[img]:https://help.github.com/assets/images/site/favicon.ico "logo"
方式1:
方式2:
說明:
URL后面的內容是鼠標hover提示文本,可以省略,省略時就沒有鼠標hover提示文本效果。
推薦使用方式2,當一個鏈接在文中多次出現的時候,就會體現出其優點了。
另外,后面的提示文本除了使用 "提示文本" 外,還可以是 '提示文本' 和 (提示文本) 。
[id]:URL "鼠標hover提示文本"
[id]:URL '鼠標hover提示文本'
[id]:URL (鼠標hover提示文本)
鏈接
鏈接根據鏈接目標可分為站內站外鏈接,按照類型可分為文本鏈接和圖片鏈接。
綜上所述,可分為以下三種:
文本鏈接
給文本信息添加超鏈接
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.文本鏈接
鏈接URL相關說明和圖片一樣,請查看
特例:
當鏈接的文本內容和鏈接Id相同的時候,可以不用寫鏈接后面的Id。
[SeayXu][]
[SeayXu]:https://github.com/SeayXu "Seay"
圖片鏈接
給圖片加上超鏈接
方式1:
[](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"
提示:由於各個Markdown解析不同,所以顯示的提示文本有可能也不太一樣。
錨點
錨點其實與文本鏈接和圖片鏈接用法是一樣的,只不過是在本頁面內,需要稍微改動下。
設置錨點鏈接目標:
<h6 id="url-more">說明:</h6>
添加錨點:
[錨點](#url-more "anchor alt text")
[錨點][anchor]
[anchor]:#url-more "anchor alt text"
說明:相對於文本鏈接和圖片鏈接,主要是添加了錨點鏈接目標這一操作,使用語法跟文本鏈接和圖片鏈接一樣。
列表
列表分為有序和無序兩種。
無序列表
無序列表有三種表示方法: *
、 + 和 -。
下級在上級基礎上前面多加兩個空格,符號與內容直接有一個空格。
無序列表1:
* 一級條目1
* 一級條目2
* 二級條目1
* 二級條目2
* 三級條目1
* 三級條目2
* 三級條目3
* 二級條目3
* 一級條目3
- 一級條目1
- 一級條目2
- 二級條目1
- 二級條目2
- 三級條目1
- 三級條目2
- 三級條目3
- 二級條目3
- 一級條目3
在這里只演示一種,另外兩種就是把 *
分別換成 + 和 - 。
有序列表
有序列表與無序列表類似,只不是是將前面的符號換成數字而已。
1. 一級條目1
2. 一級條目2
1. 二級條目1
* 二級條目2
* 三級條目1
+ 三級條目2
- 三級條目3
- 二級條目3
2. 一級條目3
- 一級條目1
- 一級條目2
- 二級條目1
- 二級條目2
- 三級條目1
- 三級條目2
- 三級條目3
- 二級條目3
- 一級條目3
說明:
- 有序列表有自動糾錯功能,當序號輸入錯誤時,會自動更正顯示序號。
- 有序列表可結合無序列表,只在第一個條目輸入序號后,同級條目會自動編號。
引用
引用內容可以嵌套引用和使用其他語法,在引用內容后面空一行就表示引用結束。
>這是一段包含**加粗**的 _斜體_ 和 _**斜粗體**_ 並帶有`高亮`顯示的一段文本來自[我的Github](https://github.com/SeayXu "SeayXu")。
我是圖片:
![github logo][github-img]
[github-url]:https://github.com/SeayXu "SeayXu"
這是一段包含加粗的 斜體 和 斜粗體 並帶有
高亮
顯示的一段文本來自我的Github。
我是圖片:
本文來自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處,可隨時與我聯系。