MarkDown文件的編寫

走进舒适圈發表於2024-12-08

MarkDown的基本語法

MarkDown的標題語法

 透過#進行建立標題,#的數量控制標題的級別

MarkDown的段落語法

 透過空白行將一行或者多行文字進行分隔

MarkDown的強調語法

粗體

 使用兩個*或者兩個_包裹

斜體

 使用一個*或者一個_包裹

粗體和斜體

 使用三個*或者三個_包裹

MarkDown的引用語法

 透過在段落前新增>進行建立塊引用
 有多行的話,在段落之間的空白行新增>
 它也可用進行巢狀使用>>

MarkDown的列表語法

有序列表

 要建立有序列表,請在每個列表項前新增數字並緊跟一個英文句點。數字不必按數學順序排列,但是列表應當以數字 1 起始。

無序列表

 要建立無序列表,請在每個列表項前面新增破折號 (-)、星號 (*) 或加號 (+) 。縮排一個或多個列表項可建立巢狀列表。

在列表中巢狀其他元素

 要在保留列表連續性的同時在列表中新增另一種元素,請將該元素縮排四個空格或一個製表符。

MarkDown的程式碼語法

 要將單詞或短語表示為程式碼,請將其包裹在反引號 (`) 中。如果你要表示為程式碼的單詞或短語中包含一個或多個反引號,則可以透過將單詞或短語包裹在雙反引號(``)中。

MarkDown的分割線語法

 要建立分隔線,請在單獨一行上使用三個或多個星號 (***)、破折號 (---) 或下劃線 (___) ,並且不能包含其他內容。

MarkDown的連結語法

 超連結Markdown語法程式碼:[超連結顯示名](超連結地址 "超連結title")

給連結新增title

 連結title是當滑鼠懸停在連結上時會出現的文字,這個title是可選的,它放在圓括號中連結地址後面,跟連結地址之間以空格分隔。

網址和email地址

 使用尖括號可以很方便地把URL或者email地址變成可點選的連結。

MarkDown的跳脫字元

 顯示原本用於格式化 Markdown 文件的字元,請在字元前面新增反斜槓字元\

MarkDown內嵌HTML標籤

行級內聯標籤

 HTML 的行級內聯標籤如 <span>、<cite>、<del> 不受限制,可以在 Markdown 的段落、列表或是標題裡任意使用。依照個人習慣,甚至可以不用 Markdown 格式,而採用 HTML 標籤來格式化。例如:如果比較喜歡 HTML 的 <a><img> 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是圖片語法。當你需要更改元素的屬性時(例如為文字指定顏色或更改影像的寬度),使用 HTML 標籤更方便些。

區塊標籤

 區塊元素──比如 <div>、<table>、<pre>、<p> 等標籤,必須在前後加上空行,以便於內容區分。而且這些元素的開始與結尾標籤,不可以用 tab 或是空白來縮排。Markdown 會自動識別這區塊元素,避免在區塊標籤前後加上沒有必要的 <p> 標籤。

相關文章