初識Markdown

*一、Markdown是什么 *

Markdown是一種輕量級的標記語言,使用的標記語法非常簡單,它可以使用純文本編輯器來創建豐富的文本,并可以被轉換為.html.pdf和本身的.md文件。

二、Markdown常用語法

1. 標題

Markdown支持兩種標題的語法,類 Atx 和類 Setext形式。

1.1 類 Atx 形式

在文字前加#即可定義標題,共六級標題,#與標題之間加一空格,如下:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

效果如下:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

<br />

1.2 類 Setext 形式

個人覺得不如類Atx方便,這里就不介紹了,有興趣的可以參考Markdown 中文版語法說明

2. 引用

2.1 單行引用

引用別處的文字,可以使用>加引用的內容即可,符號和引用內容之間加一空格。

> 這里是引用的內容

效果如下:

這里是引用的內容

2.2 區塊引用

也可以區塊引用:

> 這里是引用區塊的內容
> 這里是引用區塊的內容
> 這里是引用區塊的內容

還可以只在整個段落的第一行最前面加上>來區塊引用:

> 這里是引用區塊的內容,這里是引用區塊的內容;
這里是引用區塊的內容,這里是引用區塊的內容。
這里是引用區塊的內容,這里是引用區塊的內容。

效果如下:

這里是引用區塊的內容
這里是引用區塊的內容
這里是引用區塊的內容

2.3 引用嵌套

區塊引用還可以嵌套使用:

> 這里是引用區塊的內容
> > 這里是嵌套的引用區塊的內容

效果如下:

這里是引用區塊的內容

這里是嵌套的引用區塊的內容

2.4 嵌套其他

引用區塊內還可以嵌套使用其他的 Markdown 語法,如標題、列表、代碼區塊等:
> 這是引用區塊
> #引用區塊內的標題一
> * 引用區塊內的列表
> \ <p>Markdown<p/>` `

效果如下:

這是引用區塊

引用區塊內的標題

  • 引用區塊內的列表
    <p>Markdown<p/>

3. 列表

在文字前加上+-或者*即可變為無序列表,加上1. 2. 3. 即可變為有序列表,符號和列表項內容之間加一空格。

3.1 無序列表

+ 無序列表項1
+ 無序列表項2
+ 無序列表項3

- 無序列表項1
- 無序列表項2
- 無序列表項3
或者
* 無序列表項1
* 無序列表項2
* 無序列表項3

效果如下:

  • 無序列表項1
  • 無序列表項2
  • 無序列表項3

3.2 有序列表

1. 有序列表項1
2. 有序列表項2
3. 有序列表項3

有序列表標記上使用的數字并不會影響輸出的結果,如下:
1. 有序列表項1
1. 有序列表項2
1. 有序列表項3
或者
3. 有序列表項1
2. 有序列表項2
8. 有序列表項3

輸出的效果都是如下所示的有序列表:

  1. 有序列表項1
  2. 有序列表項2
  3. 有序列表項3

不過建議第一個列表項目最好還是從1. 開始,因為 Markdown 未來可能會支持有序列表的 start 屬性,即設置有序列表起始列表項的序列號數字。

3.3 列表縮進

列表項標記也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
列表項標記也可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或 1 個制表符。
當我們需要讓列表看起來更漂亮時,就可以把內容用固定的縮進整理好。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表; 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
或者不整理:
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。 項內容這里是列表項內容這里是列表項內容這里是列表項內容。
* 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項, 內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表; 項內容這里是列表項內容這里是列表項內容這里是列表項內容。

效果是一樣的,如下:

  • 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項,
    內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表。
    項內容這里是列表項內容這里是列表項內容這里是列表項內容。
  • 這里是列表項內容這里是列表項內容這里是列表項內容這里是列表項,
    內容這里是列表項內容這里是列表項內容這里是列表項內容這里是列表;
    項內容這里是列表項內容這里是列表項內容這里是列表項內容。

3.4 列表嵌套其他內容

在列表項目內放引用時,> 需要縮進。放代碼區塊的話,該區塊就需要縮進* 兩次*,也就是 8 個空格或者 2 個制表符。
* 列表項
> 引用
* 列表項
<p>這里是代碼<p/>

效果如下:

  • 列表項

    引用

  • 列表項
    <p>這里是代碼<p/>

3.5 意外列表

無意中產生的列表:

1986. What a great season.

效果如下:

  1. What a great season.

可以做如下處理:

1986\. What a great season.

效果如下:

1986. What a great season.

也就是在行首出現數字-句點-空白,要避免這樣的狀況,可以在句點前面加上反斜杠轉義。

4. 代碼區塊與分割線

4.1 代碼區塊

Markdown 中建立代碼區塊很簡單,只要簡單地縮進 4 個空格或是 1 個制表符就可以了。不過貌似簡書需要兩個制表符才行。

<h2>代碼區塊的標題<h2/>
<p>代碼區塊的內容<p/>

效果如下:

<h2>代碼區塊的標題<h2/>
<p>代碼區塊的內容<p/>

一個代碼區塊會一直持續到沒有縮進的那一行(或是文件結尾)。

如果要標記一小段行內代碼,你可以用反引號`把它包起來。如\ <p> <p/>` 效果為 <p> <p/>`。

4.4 分割線

在一行中用三個以上的星號、減號、底下劃線來建立一個分隔線,行內不能有其他東西。不過可以在星號或是減號中間插入空格。
***
---
___
* * *
- - -
_ _ _
效果一樣的,如下:


如果要做連續的下劃線,最好在每一行的符號后面加一空行,不然可能會出問題,不知是簡書這樣還是都是這樣。

5. 鏈接與圖片

插入鏈接與插入圖片的語法很像,區別在于插入圖片前面多一個感嘆號!

5.1 插入鏈接

[鏈接描述](這里是鏈接的地址)

效果如下:
這里是鏈接的描述

5.2 插入圖片

插入圖片的地址需要圖床,別人推薦 CloudApp 的服務,生成URL地址即可。ps:我沒有用過<sub />
簡書可以直接把圖片拖過來。
![圖片描述](圖片URL "圖片title") <small>——圖片title是可選項<small />

效果如下:


乘風破浪

6. 強調和轉義

Markdown 使用星號*和底線_作為標記強調字詞的符號。
用一個*或者_包含一段文本得到的是斜體,用兩個*或者_ 包含一段文本得到的是粗體。開始和結束的符號要相同。轉義在前面加上轉義字符 \ 即可,如:*。

*斜體*
**粗體**
_斜體_
__粗體__

效果如下:

斜體 粗體斜體 粗體

*_兩邊都有空白的話,它們就只會被當成普通的符號。如*結果就是 *, _結果就是 _ 。
如果要在文字前后直接插入普通的星號或底線,你可以用反斜線轉義。如\*結果就是*, \_結果就是 _ 。

6. 表格

表格是比較麻煩的
|表頭 |表頭|表頭|表頭| | -|:--| ---:| :----:| |單元格| |單元格|單元格| |單元格|單元格|單元格|單元格| |單元格|單元格|單元格|單元格|

  • ||表示空單元格
  • 表頭下一行中-數量無關單元格寬度,根據列數均分寬度
  • 表頭下一行中的:表示的是文字的對齊方式,不設置則只是表頭文字居中;在-左邊則居左,右邊居右,在-兩邊各有一個:則居中
  • 合并單元格等其他單元格有關內容另行搜索

效果如下:
表格與整個表格前面的文字之間需要加一空行。

表頭 表頭 表頭 表頭
單元格 單元格 單元格
單元格 單元格 單元格 單元格
單元格 單元格 單元格 單元格

總結

以上是我在簡書上學習使用Markdown的練習,感覺<big>空一行<big />好重要啊,很多時候因為沒有空一行都會導致一些意外。
本文主要參考Markdown 中文版語法說明。如果想要了解更多有關Markdown語法的內容,請閱讀Markdown 中文版語法說明

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 前言: Markdown所具備的諸多優點,致使其在程序員、極客圈、自媒體圈和作家圈非常流行。 markdown優點...
    波段頂底閱讀 3,684評論 0 5
  • 開始是使用為知筆記作為平時的記錄, 發現為知可以安裝插件 「 Editor.md 」使用 Markdown 寫...
    AlvinMi閱讀 342評論 0 0
  • 一、概述# Markdown是一種輕量級的標記語言,他的目標是實現易讀易寫,一份使用Markdown格式撰寫的文件...
    sunnyaxin閱讀 1,550評論 2 3
  • 標題黨,是我前天買的一本書的名字,瘋狂英語創始人李陽的書。 我喜歡看書,但一般情況下不買書。很簡單,因為我要省錢。...
    楊文華閱讀 1,233評論 0 1
  • 晚安 愿今夜的你好夢 酣睡到天亮 么么噠
    來福是只貓閱讀 134評論 0 0