初識Markdown

*一、Markdown是什么 *

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

二、Markdown常用語法

1. 標題

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

1.1 類 Atx 形式

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

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

效果如下:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

<br />

1.2 類 Setext 形式

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

2. 引用

2.1 單行引用

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

> 這里是引用的內(nèi)容

效果如下:

這里是引用的內(nèi)容

2.2 區(qū)塊引用

也可以區(qū)塊引用:

> 這里是引用區(qū)塊的內(nèi)容
> 這里是引用區(qū)塊的內(nèi)容
> 這里是引用區(qū)塊的內(nèi)容

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

> 這里是引用區(qū)塊的內(nèi)容,這里是引用區(qū)塊的內(nèi)容;
這里是引用區(qū)塊的內(nèi)容,這里是引用區(qū)塊的內(nèi)容。
這里是引用區(qū)塊的內(nèi)容,這里是引用區(qū)塊的內(nèi)容。

效果如下:

這里是引用區(qū)塊的內(nèi)容
這里是引用區(qū)塊的內(nèi)容
這里是引用區(qū)塊的內(nèi)容

2.3 引用嵌套

區(qū)塊引用還可以嵌套使用:

> 這里是引用區(qū)塊的內(nèi)容
> > 這里是嵌套的引用區(qū)塊的內(nèi)容

效果如下:

這里是引用區(qū)塊的內(nèi)容

這里是嵌套的引用區(qū)塊的內(nèi)容

2.4 嵌套其他

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

效果如下:

這是引用區(qū)塊

引用區(qū)塊內(nèi)的標題

  • 引用區(qū)塊內(nèi)的列表
    <p>Markdown<p/>

3. 列表

在文字前加上+、-或者*即可變?yōu)闊o序列表,加上1. 2. 3. 即可變?yōu)橛行蛄斜?,符號和列表項?nèi)容之間加一空格。

3.1 無序列表

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

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

效果如下:

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

3.2 有序列表

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

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

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

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

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

3.3 列表縮進

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

效果是一樣的,如下:

  • 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項,
    內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表。
    項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
  • 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項,
    內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表;
    項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。

3.4 列表嵌套其他內(nèi)容

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

效果如下:

  • 列表項

    引用

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

3.5 意外列表

無意中產(chǎn)生的列表:

1986. What a great season.

效果如下:

  1. What a great season.

可以做如下處理:

1986\. What a great season.

效果如下:

1986. What a great season.

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

4. 代碼區(qū)塊與分割線

4.1 代碼區(qū)塊

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

<h2>代碼區(qū)塊的標題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>

效果如下:

<h2>代碼區(qū)塊的標題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>

一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結(jié)尾)。

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

4.4 分割線

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


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

5. 鏈接與圖片

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

5.1 插入鏈接

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

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

5.2 插入圖片

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

效果如下:


乘風(fēng)破浪

6. 強調(diào)和轉(zhuǎn)義

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

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

效果如下:

斜體 粗體斜體 粗體

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

6. 表格

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

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

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

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

總結(jié)

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

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

友情鏈接更多精彩內(nèi)容