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 支援有序列表和無序列表
- 無序列表
無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記
- 有序列表
有序列表則使用數字接著一個英文句點(.)
程式碼區塊
縮排 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外掛