Markdown學習筆記(更新)

簡介

目标

輕量級的标記型語言，相容 HTML， 易讀易寫

文法的目标是：成為一種适用于網絡的書寫語言

格式文法在HTML區塊标簽内無效，而在HTML區段标簽内有效

自動轉換，不須特殊處理 < 與 &

工具：Atom、Marp、VSCode、Typora

本文章将原來的文章的内容用Markdown編輯器重新編輯美化了一下。在原文章中，我使用了Markdown的文法，但因為它是在CSDN的富文本編輯器中編輯的，也就沒能展示出它應有的效果。有興趣的話可以跳過去看看原文章。位址：

https://blog.csdn.net/qq_29695701/article/details/79694220

一、區塊元素

1. 段落和換行
2. 标題
3. 區塊引用
4. 清單
5. 代碼區塊
6. 分隔線

1. 段落和換行

段落由一個或多個連續的文本行組成，它的前後要有一個以上的空行。

普通段落不該用空格或制表符來縮進。

注：插入

<br/>

強制換行，但仍舊屬于同一段落。有些支援回車，有些則不支援

2. 标題

• 類 Setext：利用

  =

  與

  -

  ，至少兩個。

示例：

類 Setext

------

顯示為：

類 Setext

• 類 Atx 形式：行首（必須）插入 1 到 6 個 # ，标題文字前加空格，閉合後更美觀

示例：

## 這是 H2

## 這是 H2 ##

顯示為：

這是 H2

這是 H2

3. 區塊引用

使用

>

，可以嵌套。

引用的區塊内可以使用其他的 Markdown 文法。

第一層

第二層

4. 清單

• 無序清單

  标記：

  *

  、

  +

  、

  -

  加空格。可混用，非第一項可以使用有序清單标記

• 有序清單

  标記：第一項必須數字 + 英文句點，可無序，非第一項可使用

  *

  、

  +

  、

  -

一般情況下，清單标記最多可縮進3個空格，标記後面必須至少一個空格或制表符；

清單内部可嵌套，但屬于子項的标記符号應相對于其父标記縮進；

項目内可使用 段落 和 區塊引用，留心項目間的空行。

5. 代碼區塊

• 方法一：

  縮進 4 個 空格 或是 1 個 制表符。

  前面必須空一行，并且在代碼區塊中，Markdown 文法不會被轉換。

• 方法二：

  塊前塊後使用三個連續的 “ ` ” 包裹起來。

6. 分隔線

一行中使用三個以上的

*

、

-

、

_

來建立一個分隔線。

行内可有空格，建議使用下劃線

二、區段元素

1. 連結
2. 強調
3. 代碼
4. 圖檔

1. 連結

行内式 的連結：

[Key](LinkPath "Option Title")

參考式 的連結：

[Key][id] (另起它行) id：[id]: LinkPath "Option Title"

隐式連結 ：省去id，直接定義Key

id不區分大小寫，位置任意；Title不限于使用雙引号，還可以單引、括号

連結網址可以用 <> 限定

2. 強調

使用

*

或

_

，下劃線更易讀。

示例：

斜體強調:

_被強調的文字_

粗體強調：

__被強調的文字__

粗體加斜體強調：

___被強調的文字___

注：Marp不支援下劃線

3. 代碼

标記一小段行内代碼 ：用一對反引号

`

包起來

在代碼區段内插入反引号：多個反引号來開啟和結束代碼區段

代碼段中插入個單引号的方式：`` ` ``

碼區段内的

&

和

<

都會被自動地轉成 HTML 實體

4. 圖檔

與連結方式相似，但要在非定義的

[Key]

前加

!

不同的是，Key不會被顯示，但Title會被顯示

隻能插入圖檔，但不能設定寬度

其它

• 自動連結：隻要是用

  <>

  包起來， Markdown 就會自動把它轉成連結。
• 反斜杠

  \

  ：轉義

相關連結：

• https://github.com/tomeasure/Markdown-Learning-Note/
• https://www.appinn.com/markdown/
• http://www.markdown.cn/
• https://www.jianshu.com/p/e063303317cb/
• http://tinylab.org/use-markdown-to-write-slides/
• https://github.com/yhatt/marp/releases/