Markdown通用的常用語法說明


前言

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:
![文本內容](https://help.github.com/assets/images/site/favicon.ico "logo")
方式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"

SeayXu

圖片鏈接

給圖片加上超鏈接

方式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:
Github
方式2:
Github

提示:由於各個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. 一級條目1
  2. 一級條目2
  3. 二級條目1
  • 二級條目2
    • 三級條目1
    • 三級條目2
    • 三級條目3
  • 二級條目3
  1. 一級條目3

說明:

  1. 有序列表有自動糾錯功能,當序號輸入錯誤時,會自動更正顯示序號。
  2. 有序列表可結合無序列表,只在第一個條目輸入序號后,同級條目會自動編號。

引用

引用內容可以嵌套引用和使用其他語法,在引用內容后面空一行就表示引用結束。

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

這是一段包含加粗斜體斜粗體 並帶有高亮顯示的一段文本來自我的Github
我是圖片:
github logo

本文來自:markdown-general-common-syntax
本文就介紹到這里,如有不足之處,可隨時與我聯系。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM