Markdown基礎語法(上)
前言
按照官方文件，和根據自己所用和所理解所寫
一.標題語法
一級標題最大，六級標題最小
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
二.段落語法
一個回車一個段落
我是真的喜歡你
不，你是個好人。
三.換行語法
在一行的末尾新增兩個或者多個空格然後回車就可以建立一個換行
官方說的是還是直接回車鍵實現換行。我在換行的地方輸入了 br
可以對比段落語法和換行語法一行的間距區別，還是很明顯的。
這是第一行
這是第二行
四.強調語法
如果要加粗文字在單詞或者短語前後加上
加上兩個**即可，或者兩個下劃線
正常字型
1.粗體
加粗
但是我的建議是使用**來實現加粗
渲染程式碼如下
**加粗**
**加粗**
第二種語法在長句無效
2.傾斜
傾斜
渲染程式碼如下
_傾斜_
3.斜體加粗
斜體加粗
渲染程式碼如下
**_斜體加粗_**
五.引用語法
1.單個引用
如果要建立引用在段落前面加上">"
I really like you
> I really like you
2.多個引用
Do you like rain?
yes
渲染程式碼如下
> Do you like rain
>
> yes
3.多層引用
一二三四五
六七八九十
十一十二十三
十四十五
十六十七
十八十九
渲染程式碼如下
> 一二三四五
>
> > 六七八九十
> >
> > > 十一十二十三
> > >
> > > > 十四十五
> > > >
> > > > > 十六十七
> > > > >
> > > > > > 十八十九
4.帶有其他元素的塊引用
四級標題
測試 1
測試 2
測試 測試 測試
渲染程式碼如下
> 四級標題 > > - 測試 1 > - 測試 2 > > _測試_ 測試 **測試**
六.列表語法
1.有序列表
需要注意的是“.”的後面有一個空格
- 第一個
- 第二個
- 第三個
- 第四個
渲染程式碼如下
1. 第一個
2. 第二個
3. 第三個
4. 第四個
- 第一個
- 第二個
- 第三個
- 第三點一個
- 第三點二個
- 第四個
渲染程式碼如下
1. 第一個
2. 第二個
3. 第三個
1. 第三點一個
2. 第三點二個
4. 第四個
2.無序列表
和上面的有序列表差不多都有空格
- 第一個
- 第二個
- 第三個
- 第四個
渲染程式碼如下
- 第一個
- 第二個
- 第三個
- 第四個
另外一種方法，一樣的效果
- 第一個
- 第二個
- 第三個
- 第四個
渲染程式碼如下
* 第一個
* 第二個
* 第三個
* 第四個
層級
- 第一個
- 第二個
- 第三個
- 第一個
- 第二個
- 第三個
- 第四個
渲染程式碼如下
- 第一個
- 第二個
- 第三個
- 第一個
- 第二個
- 第三個
- 第四個
3.在列表中套用其他元素
3.1段落
-
第一個
-
第二個
我是第三個
-
第四個
渲染程式碼如下
- 第一個
- 第二個
我是第三個
- 第四個
3.2引用
-
第一個
-
第二個
我是第三個
-
第四個
渲染程式碼如下
- 第一個
- 第二個
> 我是第三個
- 第四個
3.3程式碼塊
-
第一個
-
第二個
測試 -
第三個
渲染程式碼如下
1. 第一個
2. 第二個
<html>
<head>
<title>測試</title>
</head>
</html>
3. 第三個
3.4列表
- 第一個
- 第二個
- 第一個
- 第二個
- 第三個
渲染程式碼如下
1. 第一個
2. 第二個
- 第一個
- 第二個
3. 第三個
七.程式碼語法
如果要把單詞或者短語表示為程式碼就用`包裹程式碼
print是 python 的輸出語句
渲染程式碼如下
`print`是 python 的輸出語句
1.轉義符
如果需要展現出`符號，請在單詞或者短語用``包裹
Markdown程式碼表示單詞語法是`print`是對的
渲染程式碼如下
`` Markdown程式碼表示單詞語法是`print`是對的 ``
八.分割線語法
如果要使用分割線，在單獨一行使用三個或者多個***或者---或者___
並且不能包含其他內容
渲染程式碼如下
---
---
---
為了相容性在分割線前後加上空白行
九.連結語法
這是一個連結Ken 的部落格
渲染程式碼如下
這是一個連結[Ken 的部落格](https://blog.takagisan.top)
1.給連結增加 title
這是一個連結Ken 的部落格
渲染程式碼如下
這是一個連結[Ken 的部落格](https://blog.takagisan.top "Ken的部落格")
2.網址和 email 地址
使用尖括號即可方便把 URL 或者 email 地址變成可點選的連結。
渲染程式碼如下
<https://blog.takagisan.top>
<[email protected]>
3.帶格式化的連結
這是我的部落格
這是我的部落格
This is code
渲染程式碼如下
這是我的**[部落格](https://blog.takagisan.top "Ken的部落格")**
這是我的*[部落格](https://blog.takagisan.top "Ken的部落格")*
This is [`code`](#code)
4.引用型別連結
儘量如下樣式
[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle
渲染程式碼如下
- `[1]: https://en.wikipedia.org/wiki/Hobbit#Lifestyle`
十.圖片語法
要使用影象使用!在方括號裡新增替代文字在與圓括號放圖片連結
渲染程式碼如下
1.連結圖片
和上面的區別是，使用了另外一個方括號把上面的內容括起來，然後使用了另外一個圓括號
渲染程式碼如下
[](https://blog.takagisan.top)
十一.轉義字元語法
要使原本用來格式化 Markdown 的字元在，前面新增反斜槓,\即可
*我好帥*
渲染程式碼如下
\*我好帥\*
1.可做轉義的字元
根據官方文件，如下圖,下圖都可以通過反斜槓來轉義
2.特殊字元自動轉義
如下是官方文件原文
在 HTML 檔案中，有兩個字元需要特殊處理： < 和 & 。 < 符號用於起始標籤，& 符號則用於標記 HTML 實體，如果你只是想要使用這些符號，你必須要使用實體的形式，像是 < 和 &。
& 符號其實很容易讓寫作網頁檔案的人感到困擾，如果你要打「AT&T」 ，你必須要寫成「AT&T」 ，還得轉換網址內的 & 符號，如果你要連結到：
http://images.google.com/images?num=30&q=larry+bird
你必須要把網址轉成：
http://images.google.com/images?num=30&q=larry+bird
才能放到連結標籤的 href 屬性裡。不用說也知道這很容易忘記，這也可能是 HTML 標準檢查所檢查到的錯誤中，數量最多的。
Markdown 允許你直接使用這些符號，它幫你自動轉義字元。如果你使用 & 符號的作為 HTML 實體的一部分，那麼它不會被轉換，而在其它情況下，它則會被轉換成 &。所以你如果要在檔案中插入一個著作權的符號，你可以這樣寫：
©
Markdown 將不會對這段文字做修改，但是如果你這樣寫：
AT&T
Markdown 就會將它轉為：
AT&T
類似的狀況也會發生在 < 符號上，因為 Markdown 支援行內 html，如果你使用 < 符號作為 HTML 標籤的分隔符，那 Markdown 也不會對它做任何轉換，但是如果你是寫：
4 < 5
Markdown 將會把它轉換為：
4 < 5
需要特別注意的是，在 Markdown 的塊級元素和內聯元素中， < 和 & 兩個符號都會被自動轉換成 HTML 實體，這項特性讓你可以很容易地用 Markdown 寫 HTML。（在 HTML 語法中，你要手動把所有的 < 和 & 都轉換為 HTML 實體。）
十二.內嵌 HTML 標籤
如下是官方文件原文
HTML 的行級內聯標籤如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是標題裡任意使用。依照個人習慣，甚至可以不用 Markdown 格式，而採用 HTML 標籤來格式化。例如：如果比較喜歡 HTML 的 <a> 或 <img> 標籤，可以直接使用這些標籤，而不用 Markdown 提供的連結或是圖片語法。當你需要更改元素的屬性時（例如為文字指定顏色或更改影象的寬度），使用 HTML 標籤更方便些。
HTML 行級內聯標籤和區塊標籤不同，在內聯標籤的範圍內， Markdown 的語法是可以解析的。
This **word** is bold. This <em>word</em> is italic.
渲染效果如下:
This word is bold. This word is italic.
1.區塊標籤
區塊元素 ── 比如 <div>、<table>、<pre>、<p> 等標籤，必須在前後加上空行，以便於內容區分。而且這些元素的開始與結尾標籤，不可以用 tab 或是空白來縮排。Markdown 會自動識別這區塊元素，避免在區塊標籤前後加上沒有必要的 <p> 標籤。
例如，在 Markdown 檔案里加上一段 HTML 表格：
This is a regular paragraph.
<table>
<tr>
<td>Foo</td>
</tr>
</table>
This is another regular paragraph.
請注意，Markdown 語法在 HTML 區塊標籤中將不會被進行處理。例如，你無法在 HTML 區塊內使用 Markdown 形式的*強調*。
2.Html 用法最佳實踐
出於安全原因，並非所有 Markdown 應用程式都支援在 Markdown 文件中新增 HTML。如有疑問，請檢視相應 Markdown 應用程式的手冊。某些應用程式只支援 HTML 標籤的子集。
對於 HTML 的塊級元素 <div>、<table>、<pre> 和 <p>，請在其前後使用空行（blank lines）與其它內容進行分隔。儘量不要使用製表符（tabs）或空格（spaces）對 HTML 標籤做縮排，否則將影響格式。
在 HTML 塊級標籤內不能使用 Markdown 語法。例如 <p>italic and **bold**</p> 將不起作用。