Markdown使用筆記
一、段落與強調
important denotes the impossible thing to
do
Because your ugly appearance, you cannot have a happy ending.
-
使用*括起來的為斜體
-
使用**括起來的是粗體
-
使用~~括起來的是刪除線
-
在句子后面添加<br>即可換行
二、標題
在行首插入 1 到 6 個 #
(最多支持 6 級標題) ,對應到標題 1 到 6 級。
三、鏈接
(一)行內形式鏈接
對應的鏈接文字使用方括號[ ]進行標記,具體的網站鏈接使用圓括號進行包裹。
例如:
百度
(二)參考形式鏈接
參考形式的鏈接使用另外一個方括號接在鏈接文字的括號后面,而在第二個方括號里面要填入用以辨識鏈接的標簽,類似于latex中添加的keyword,作為一個標識,用作后面的引用
四、圖片
(一)行內圖片
替代文本alt text
(二)參考形式圖片
到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果需要的話,可以使用普通的標簽。

五、列表
(一)無序列表
使用*或者 +或是 -作為標志
- 你好
(二)有序列表
使用阿拉伯數字加上英文句號表示有序列表,例如1.
- 你好
- hi
(三)任務列表
使用- [ ] todo,其中 [ ]
(帶空格的中括號)表示未完成的任務,[x]
(帶字母x的中括號) 表示已經完成的任務
例如
- do
- not do
六、分割線及引用
(一)分割線
在一行中用三個或以上的*
、-
、_
來創建一個分隔線,行內不能有其他東西。你也可以在星號中間插入空白。
上面的三種符號中任選其一
寫法一:連續五個星號*
寫法二:連續五個減號
寫法三:連續五個下劃線
(二)引用
在所要引用的文字前面添加>即為對前面文字的引用。
眾所周知,小牛是一名學生
此外,在引用中可以進行二級引用,甚至更多。
眾所周知,小牛是一名學生
眾所周知,小牛是一名學生
引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼塊等:
程序員的三種美德
- 懶惰
- 急躁
- 傲慢
下面是代碼的示例:
return shell_exec("echo $input | $markdown_script");
七、代碼塊
(一)行內代碼
行內代碼就是在代碼的兩側使用``進行包裹即可
#include <iostream>
一個代碼塊會一直持續到沒有縮排的那一行(或是文檔結尾)。
在代碼塊里面, &
、 <
和 >
會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入 HTML 的原始示例代碼,例如:
(二)高亮顯示代碼段
除了縮進顯示代碼段之外,Markdown 還支持高亮顯示的代碼段,創建高亮顯示的代碼段時,將代碼段由帶有三個反引號( ```)的行圍起來,并在第一個圍欄的末尾標識上語言類型即可,比如:
def hello_world():print("Hello, World!")
八、表格
- 第一行包含表頭,并用"豎線"( | )分隔
- 第二行將標題與單元格分開,并且必須包含三個或更多破折號
- 第三行以及隨后的任何行均包含單元格值
:--:
兩端都有冒號表示內容和標題欄居中對齊:---
左側冒號表示內容和標題欄居左對齊---:
右側冒號表示內容和標題欄居右對齊
左對齊 | 居中對齊 | 右對齊 |
---|---|---|
apple | banana | cherry |
dog | cat | bird |