如果dnf開懷舊服,你們還會歸來嗎?歸來還是少年嗎?
Markdown是一種輕量級的標記語言,排版語法簡潔,讓人們更多地關注內容本身而非排版。它使用易讀寫的純文字格式編寫文件,可與HTML混編,可匯出HTML、PDF以及本身的.md格式的檔案。因簡潔、高效、易讀、易寫,Markdown被大量使用,如Github、Wikipedia、簡書等。
- Markdown基本語法地址:https://markdown.com.cn/basic-syntax/code.html
- Markdown擴充套件語法地址:https://markdown.com.cn/extended-syntax/
a%20href="https://markdown.com.cn/basic-syntax/code.html"%20title="Markdown基本語法地址:"
Markdown標題語法
注意:1. 井號+空格須放在句首,但井號不區分半形/全形。
2. 一個井號表示一級標題,兩個井號表示二級標題,依次類推,總共有六級標題。
HTML語法:xml格式 <h1>文字</h1>
1. <h1>文字</h1>須位於句首,且<>須為半形
-
h1代表一級標題,h2代表二級標題,...h6代表六級標題
Markdown可選語法:也可以在標題文字下方新增任意數量(不超過6個)=標識一級標題;在標題文字下方新增任意數量的--標識二級標題。
Markdown段落語法
Markdown段落語法:要建立段落請使用空白行將一行或者多行文字分隔。
HTML段落語法:<p>文字</p>>
注意:不要用空格或製表符(tab)縮排段落。
Markdown換行語法
Markdown換行語法:在一行的末尾新增兩個或者多個空格然後按回車鍵,即可完成換行。
HTML換行語法:<p> </p>
Markdown強調語法
粗體
Markdown加粗語法:
-
加粗文字:請在單詞或者短語的前後端各新增兩個星號(**)或者下劃線(__)
-
加粗一個單詞或者單詞的中間部分(漢語用不到加粗一個單詞的中間部分)
注意:*不區分全形/半形。
HTML加粗語法:文字
注意:加粗中間的文字不推薦使用兩個下劃線,有可能不相容。儘管漢語是可以這麼使用。
斜體
Markdown斜體語法:
-
要用斜體顯示文字:請在單詞或者短語的前後新增一個星號(*)或者下劃線(_).
-
要用斜體顯示單詞的中間部分:請在字母請後各加一個星號(*),中間不要空格。
HTML斜體語法:斜體
注意:要用斜體強調單詞中間的部分,請用星號(*)。
既加粗又傾斜
Markdown既要加粗又要傾斜的語法:
-
文字就要加粗又傾斜:請在單詞或者短語前後各新增三個星號(***)或下劃線(___)。
-
單詞或單詞中間部分既要加粗又要傾斜:請在要突出顯示的部分前後各新增三個星號,中間不要帶空格。
HTML既要加粗又要傾斜的語法:<strong><em>進行組合,須成對出現且位置須一致,否則根據第一個<>中的單詞匹配。
注意:凡是需要強調文字中間部分,儘可能不要使用下劃線,養成習慣,避免在其他地方不相容。
Markdown引用語法
-
Markdown引用語法:要建立引用,請在段落前新增一個大於號(>)。
單個段落的引用
多個段落塊的引用
塊引用可以包含多個段落。每個段落包括段落間的空行前分別新增一個大於號(>)。
巢狀塊引用
塊引用可以巢狀。在被巢狀的段落前再新增一個大於號(>)。可以主機
進行多級巢狀,只需每次在被巢狀的段落前新增一個大於號(>)即可。
帶有其他元素的塊引用
塊引用可以包含其他Markdown格式的元素。但並非所有的元素都可以使用,需要進行驗證。
Markdown列表語法
可以將多個條目組織成有序或無序列表。
有序列表
建立有序列表:需在每個列表前新增一個數字並緊跟一個半形的句點。數字不必按數學順序排列,但列表應當以數字1起始。
Markdown有序列表語法:1.
HTML有序列表語法:<ol>+<li>巢狀
注意:Markdown語法:數字後必須跟半形句號,不能是其他。
無序列表
建立無序列表:請在每個列表前新增波折號(-)、星號(*)或加號(+)。縮排一個或者多個列表可建立巢狀列表。
Markdown無序列表語法:加波折號(-)、星號(*)或加號(+)單一使用。
HTML無序列表語法:<ul>+<li>巢狀
注意:Markdown不允許加波折號(-)、星號(*)和加號(+)混合使用。
在列表中巢狀其他元素
要在保留列表連續性的同時在列表中新增另一種元素,請將該元素縮排一個製表符(tab)或者四個空格。
Markdown程式碼語法
要將單詞或短語作為程式碼
- Markdown語法:請將其包裹在反單引號(半形、tab鍵上方)中。
- HTML語法:
程式碼
轉義反引號
- Markdown轉義語法:依然使用反單引號。
- HTML轉義語法:也是使用反單引號包裹關鍵字code
程式碼塊
建立縮排的程式碼塊:請將程式碼塊每一行縮排一個製表符或者四個空格。
建立不縮排的程式碼塊:參考圍欄式程式碼塊
Markdown分割線語法
- Markdown建立分割線語法:請在單獨一行上使用三個或多個星號(***)、波折號(---)或下劃線(___)
注意:為了相容性,請在分割線前後均新增空白行
Markdown連結語法
- Markdown建立連結語法:連結文字放在方括號內,連結地址放在後面的圓括號內,連結的title可選
- Markdown建立超連結語法:[超連結顯示名](超連結地址"超連結title")
- Markdown建立超連結語法:超連結顯示名
注意:方括號和圓括號必須緊挨著,中間不能有空格
帶Title的連結
- 連結title是當滑鼠懸停在連結上是會出現的文字,這個title是可選的,它放在圓括號中連結地址後面,跟連結地址之間以空格分隔(為了相容性,請使用%20代替空格)。
- 連結title的展示
網址和email地址
- 網址和email地址的HTML語法:使用尖括號可以很方便的將URL地址或者email地址變成可點選的連結
帶格式化的連結
- 強調連結:在連結語法前後增加星號(*)
- 要將連結表示為程式碼:請在方括號中新增反引號
引用型別連結
- 引用樣式連結:是一種特殊的連結,它是url在Markdown中更易於顯示和閱讀。參考樣式連結分為兩部分:與文字保持內聯的部分以及儲存在文字中的其他位置的部分,以使文字易於閱讀。
注意:
- 連結的第一部分格式:使用兩組方括號進行格式設定。
- 第一組方括號包圍應顯示為連結的文字
- 第二組方括號顯示了一個標籤: 該標籤用於指向您儲存在文件中的其他位置的連結
- 儘管不是必須的,可以在第一組合第二組方括號之間包含一個空格。
- 第二組方括號中的標籤不區分大小寫,可以包含字母、數字、空格或者標點符號。
- 連結的第二部分格式:使用一下屬性設定格式
- 放在括號中的標籤,其後緊跟一個冒號和至少一個空格(例如[label]: )。
- 連結的URL,可以選擇將其括在尖括號中。
- 連結的可選標題,可以將其括在雙引號、單引號或者括號中
- 可以將連結的第二部分放在Markdown文件中的任何位置;有的人將它放在出現的段落之後,有的人則將它們放在文件的末尾(例如尾註或腳註)。
- 不同的Markdown應用程式處理URL中間空格的方式不一樣。為了相容性,請儘量使用%20代替空格。
Markdown圖片語法
新增圖片
要新增影象,請使用感嘆號(!)。然後在方括號增加替代文字,圖片連結放在圓括號裡,括號裡的連結後可以增加一個可選的文字標題文字。
- 插入圖片Markdown語法程式碼:![圖片alt](圖片連結"圖片title")。
- 插入圖片HTML語法:
連結圖片
- 給圖片增加連結:請將影象的Markdown括在方括號中,然後將連結新增在圓括號中。
Markdown轉義字元語法
- 要顯示原本格式化Markdown文件的字元: 請在字元簽名新增反斜槓(\)。
- 需轉義的字元
- 特殊字元自動轉義
在HTML檔案中,<和&需要特殊處理。
<
:用於起始標籤。&
:用於標記HTML實體。- 使用這些符號,必須要使用實體的形式。如
<
和&
注意:
&
很容易讓寫網頁檔案的人感到困擾,如果要打『AT&T』,必須寫成『AT&T
』;如果你要得到連結,還要轉換網址內的&
符號。
&
被轉換後的連結才能放到href
屬性裡。
Markdown允許你直接使用這些符號,他幫你自動轉義字元。如果使用
&
符號作為HTML實體的一部分,那麼他是不會被轉換,而在其他情況下,他則會被轉換成&
。所有如果在檔案中插入著作權符號,你可以寫成©
。但是,Markdown不會講AT&T這段文字進行修改,如果要寫成
AT&T
。類似的情況也發生在
<
符號上,因為Markdown支援行內HTML,如果你是用<
作為HTML標籤的分隔符,Markdown也不會對它進行任何轉換。但是你寫 4 < 5 Markdown將會轉換為4 amp; 5
。需要特別注意的是,在 Markdown 的塊級元素和內聯元素中,
<
和&
兩個符號都會被自動轉換成 HTML 實體,這項特性讓你可以很容易地用 Markdown 寫 HTML。(在 HTML 語法中,你要手動把所有的<
和&
都轉換為 HTML 實體。)
Markdown內嵌HTML語法
對於Markdown涵蓋範圍之外的標籤,都可以直接在檔案中用HTML本身。如需使用HTML,不需要額外標誌這是HTML或是Markdown,只需HTML標籤新增到Markdown文字即可。
注意:Markdown 語法在 HTML 區塊標籤中將不會被進行處理。例如,你無法在 HTML 區塊內使用 Markdown 形式的*強調*
。
行級內聯標籤
HTML中的行級內聯標籤如
<span>
、<cite>
、<del>
不收限制,可以在Markdown的段落、列表或是標題中任意使用。
如果比較喜歡HTML的
<a>
、或者<img>
標籤,可以直接使用這些標籤,而不用Markdown提供的連結或者圖片語法。當需要修改元素屬性時(例如為文字指定顏色或者更改影象的亮度),使用HTML標籤更方便些。
區塊標籤
區塊元素—比如
<div>
、<table>
、<pre>
、<p>
等標籤,必須在前後加上空行,以便內容區分。
而且這些元素的開始於結尾標籤,不可以使用
tab
或者空格
來縮排。Makedown會自動識別這些區塊元素,避免在區塊標籤前後加上沒必要的
<p>
標籤。
對於 HTML 的塊級元素
<div>
、<table>
、<pre>
和<p>
,請在其前後使用空行(blank lines)與其它內容進行分隔。儘量不要使用製表符(tabs)或空格(spaces)對 HTML 標籤做縮排,否則將影響格式。在 HTML 塊級標籤內不能使用 Markdown 語法。例如
<p>italic and **bold**</p>
將不起作用。