1. 程式人生 > >Markdown基礎知識及使用技巧整理

Markdown基礎知識及使用技巧整理

Markdown基礎知識整理

Markdown 不是想要取代 HTML,甚至也沒有要和它相近,Markdown 的構想不是要使得 HTML 文件更容易書寫。在我看來, HTML 已經很容易寫了。Markdown 的理念是,能讓文件更容易讀、寫和隨意改。HTML 是一種釋出的格式,Markdown 是一種書寫的格式。

不在 Markdown 涵蓋範圍之內的標籤,都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown,只要直接加標籤就可以了。

請注意:在 HTML 區塊標籤間的 Markdown 格式語法將不會被處理。比如,你在 HTML 區塊內使用 Markdown 樣式的 加粗

(**加粗**)會沒有效果。

標題

行首插入1到6個(#) ,對應到標題 1 到 6 階

區塊引用

Markdown 標記區塊引用是使用類似 email 中用(>)的引用方式

列表

Markdown 支援有序列表和無序列表

  1. 無序列表

無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記

  1. 有序列表

有序列表則使用數字接著一個英文句點(.)

程式碼區塊

縮排 4 個空格或是 1 個製表符

console.log("我是程式碼區塊");
alert("我是程式碼區塊");

分隔線

在一行中用三個以上的星號(*)、減號(-)、底線(_)來建立一個分隔線,行內不能有其他東西,你也可以在星號或是減號中間插入空格。

連結

在方塊括號後面緊接著圓括號,方括號裡寫連結文字,圓括號寫連結,如果你還想要加上鍊接的 title 文字,只要在網址後面用雙引號("")把 “title” 文字包起來即可

這是連結到百度的連結

強調

使用星號(*)和底線(_)作為標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 <em>(傾斜) 標籤包圍,用兩個 * 或 _ 包起來的話,則會被轉成 <strong>(加粗)

如果要在文字前後直接插入普通的星號或底線,你可以用反斜線(\)

標記文字

使用兩個等號(==)包裹文字

我是標記文字

刪除文字

使用兩個波浪號(~~)包裹文字

我是刪除文字

下標,上標

使用一個波浪號(~)包裹文字是下標,使用一個(^)包裹文字是上標

示例

H~2~O 是是液體
2^10^ 運算結果是 1024

結果
H2O 是是液體
210 運算結果是 1024

程式碼

用一個反引號把它包起來(`)

Use the printf() function.

表格

使用一個豎線(|)分割列,表頭與內容用(- | - | -)分割

例子

手機 | 價格 | 配置
- | - | -
小米6 | 2999 | 6GB+128GB
華為Mate20 | 3999 | 6GB+64GB
iPhoneX | 8278 | 3GB+256GB

結果

手機 價格 配置
小米6 2999 6GB+128GB
華為Mate20 3999 6GB+64GB
iPhoneX 8278 3GB+256GB

註釋

在方括號中寫要標記的內容,後面接著一個分號(:),分號後面寫要註釋的內容,標記內容要與顯示的內容一樣,並且要與顯示的內容至少有一個換行

示例

HTML

[HTML]: 超文字標記語言

結果
HTML

圖片

一個驚歎號(!),接著一個方括號,接著一個圓括號,方括號裡面放上圖片的替代文字,圓括號放上圖片的網址,最後還可以用引號包住並加上 選擇性的 ‘title’ 文字

圖片示例

自動連結

反斜槓

可以利用反斜槓(\)來插入一些在語法中有其它意義的符號

Markdown 支援以下這些符號前面加上反斜槓來幫助插入普通的符號.

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚歎號

編輯器

可以使用MarkdownPad2編輯Markdown檔案,如果使用vscode,可以安裝Markdown Preview Enhance外掛