Markdown语法:基础编写方式

一、为什么使用Markdown?

使用Markdown的契机在于自己建立的blog网站,在发布博文是不可能只是发布一段纯粹的文本吧,没有样式,没有标题,这样子会导致阅读时比较困难,因此使用Markdown就非常必要了。

Markdown正在成为一种流行的标记语言,得益于它易写易读的特性,在程序员这一群体中使用越来越广泛

接下来简单讲解一下Markdown的一些基本问题,不深入探讨Markdown的其他问题,仅专注如何使用Markdown进行文章编写。


二、Markdown是什么?

1、含义

Markdown是一种轻量级标记语言,在编辑文本是通过在文本的前或后加入各种标记,从而可以快速将输入的文本内容进行排版的一种语言。

Markdown是一种文档的格式,文件后缀为.md,我们常用的word后缀为.doc``.docx

2、与常见的富文本编辑器区别

Markdown与常见的富文本编辑器(如word)的作用是一致的:二者都是通过对纯文本进行编辑,从而使纯文本呈现出不同的样子(如:文字颜色、大小等);这里的纯文本是指用户在编辑器输入的一段没有做过任何处理的文本数据

而两者不同点在于:富文本编辑器通常在输入文本之后通过点击某一项功能来调整文本(如点击字体大小功能改变字体大小) ;Mardkown则是在输入文本时通过在文本前后加入标记来实现改变文本的样式(如输入 ### 标题 这样可以得到一个三级标题)

3、Markdown的优势

在使用富文本编辑器编辑文字是是两个不同的动作,通常输入完文本再去找相应的功能来调整文本样式,而且一般都是写完一段文本就会选择去调整文本样式,故而无法保持一个流畅的写作思路

而Markdown的优势则在于我们在书写过程中不用刻意停下调整样式,注意力没有受到影响,故而能保持一个书写流畅的状态;这种方式就好比我们传统的纸笔写作,注意力始终集中在文字上


三、Markdown工具推荐

在使用Markdown编写文档之前,一件称手的编辑工具是必不可少的,我推荐的是Typora

[图片上传失败...(image-579b5e-1659974940924)]

它同时可以支持Windows、Linux和Mac

vsCode也是一款不错的编辑工具,vsCode提供编写跟预览两个窗口;而Typora则是编写跟预览两者的结合,在编写的同时即可直接显示效果, 对于个人来说更加符合所见即所得的Markdown理念

除此之外还有许多优秀的编辑工具,这里不做过多介绍


四、如何使用Markdown?

1、标题

使用`#`号加空格进行标记,一个`#`号代表一级,两个代表二级,以此类推,`#号后面必须带空格,否则无效果`

# 我是一级标题

## 我是二级标题

### 我是三级标题

#### 我是四级标题

##### 我是五级标题

###### 我是六级标题

[图片上传失败...(image-285e2f-1659974940924)]

2、字体

使用一个`*`或者`_`号表示斜体文本;使用两个`*`或者`_`号表示粗体文本;使用三个`*`或者`_`号表示粗斜体文本

*我是斜体文本*

_我是斜体文本_

**我是粗体文本**

__我是粗体文本__

***我是粗斜体文本***

___我是粗斜体文本___

效果如下:


我是斜体文本

我是斜体文本

我是粗体文本

我是粗体文本

我是粗斜体文本

我是粗斜体文本

3、分割线

使用连续三个的减号`---`、下划线`___`或者星号`***`都可以实现下划线效果,三种方式都必须有`至少三个符号`(即三个减号或三个星号)

---

___

***

效果如下:




4、删除线

使用连续的两个`~~`在文本的前后加入即可

~~我被删除了~~

同时也可以搭配一些其他的标记**~~我是被删除的粗体文本~~**

或者~~**我是被删除的粗体文本2**~~

效果如下:


我被删除了

我是被删除的粗体文本

我是被删除的粗体文本2

5、下划线

使用标签`<u></u>`实现下划线

<u></u>

效果如下:


<u>我脚下有下划线</u>

6、脚注

使用`[^要注明的文本]`实现脚注,如下所示:首先定义脚注,其次在下方输入脚注说明

[^要注明的文本]

[^要注明的文本]:脚注本注

效果如下:


我后面的这个就是脚注[1]

7、列表

7.1、有序列表

使用“数字加. ”的方式组成(即1. ),.后面需要加空格再输入文本,一般第二项不用输入,直接回车即自动出现第二项,这个需要看编辑器是否支持。

1. 第一项

2. 第二项

3. 第三项

效果如下:


  1. 第一项
  2. 第二项
  3. 第三项

7.2、无序列表

使用*、+或者-号都可以,符号后面需要加空格再输入文本,一般第二项不用输入,直接回车即自动出现第二项,这个需要看编辑器是否支持。

* 第一项

* 第二项

+ 第一项

+ 第二项

- 第一项

- 第二项

三者效果均如下:

  • 第一项
  • 第二项

只需在第一项下面键入一个制表(即table)然后输入任意的*、+或者-号都可以实现(有些编辑器在键入制表之后会自动生成二级三级列表),三级列表以此类推

二级列表效果如下:


  • 第一项
    • 第二项

三级列表效果如下:


  • 第一项
    • 第二项
      • 第三项

7.3、有序与无序结合

1. 第一项:

- 第一项第一个

- 第一项第二个

2. 第二项:

- 第二项第一个

- 第二项第二个

效果如下:


  1. 第一项:
    • 第一项第一个
    • 第一项第二个
  2. 第二项:
    • 第二项第一个
    • 第二项第二个

7.4、任务列表

使用*+-其中一个与[ ]组,*+-后面必须有空格,[ ]中间必须有空格;在[]中间填入字母x可实现选中效果,也可以在效果出来后直接勾选进行选中

* [ ] 测试*

+ [ ] 测试+

- [ ] 测试-

* [x] 测试选中

效果如下:


  • 测试*
  • 测试+
  • 测试-
  • 测试选中

8、区块

8.1、单层区块

使用>标记,> 后面需要加空格,否则无效果

> 区块

效果如下:

区块


8.2、多层区块

只需在区块里再使用>即可在区块中再出现嵌套的区块,可以嵌套多层区块

多层区块效果如下:

> 第一层区块

`> 第二层区块`

    `> 第三层区块`

效果如下:

第一层区块

第二层区块

第三层区块

8.3、列表中使用区块

只需在二级列表中输入>即可,这一块区块等级等同于一级列表,以此类推出第二、三..级列表

* 一级列表第一项

`>一级列表第一项列表区块第一行 `

`>一级列表第一项列表区块第二行 `

* 一级列表第二项

效果如下:

  • 一级列表第一项

    一级列表第一项列表区块第一行

    一级列表第一项列表区块第二行

  • 一级列表第二项

    一级列表第二项列表区块第一行

    • 二级列表第一项

      二级列表第一项列表区块第一行

9、代码块

使用`文本`号对需要高亮提示的文本或者函数进行标注,(这个看使用习惯)

`main()`函数

效果如下:


main()函数

注:高亮方式还有使用==文本==的形式实现,但个人感觉`文本`更好用,文本更高亮。


使用` ````进行标记,输入代码语言回车即可创建属于该语言的代码块

```java +回车

效果如下:



10、链接

10.1、包裹型链接

使用<url> 的形式写入,在某些编辑器下会有带下划线的效果。

<http://www.gocit.cn>

效果如下:


http://www.gocit.cn

10.2、命名链接

使用[链接名称](url "可选备注")的形式写入,不直接显示链接,而是显示链接名称。

[猪猪杀手的blog](www.gocit.cn)

效果如下:


猪猪杀手的blog

10.3、跳转链接

使用[链接名称](#标题名称)的形式写入,标题名称必须存在且名称前需要输入#号,该链接可以直接在页内跳转

标题讲解请见[标题](#1、标题)

效果如下:


标题讲解请见标题

10.4、高级链接

通过变量设置一个链接,变量在链接后或者文章末尾赋值。

我是由变量设置的链接A[我的blog][A]

我是由变量设置的链接B[百度一下][B]

下面是变量的赋值(变量赋值在效果中不会显示)

[A]:http://www.gocit.cn

[B]:http://www.baidu.com

效果如下:


我是由变量设置的链接A我的blog

我是由变量设置的链接B百度一下

下面是变量的赋值(变量赋值在效果中不会显示)

11、图片

使用[图片上传失败...(image-c0c8db-1659974940924)]的方式插入图片(可选标题为鼠标放置在图片中不动时的提示文字),图片插入的方式与链接 方式相似,但前面多一个感叹号

[图片上传失败...(image-9dd5f2-1659974940924)]

[图片上传失败...(image-ebe951-1659974940924)]

[图片上传失败...(image-d83e-1659974940924)]

[图片上传失败...(image-15b5eb-1659974940924)]

也可以使用网址的方式

[链接图片示例][pic]

[pic]:http://qiniu.gocit.cn/Markdown%E8%AF%AD%E6%B3%95%E5%BC%80%E7%AF%87/Markdown_pic_3.png?imageslim

⚠️:pic是对上面链接图片示例的pic赋值,可以放在文章最下面;这里对链接的赋值不会在效果中显示,只会显示一个可点击的链接图片示例

效果如下:

链接图片示例

12、表格

使用|来分隔不同单元格,使用-来分隔表头和数据行。

| 表头列1 | 表头列2 | 表头列3 | | -----| ---- | ---- | | 一行一列 | 一行二列 | 一行三列 | | 二行一列 | 二行二列 | 二行三列 |

效果如下:


表头列1 表头列2 表头列3
一行一列 一行二列 一行三列
二行一列 二行二列 二行三列

分别使用:--::-:表示左对齐、右对齐、居中对齐

| 表头列1 | 表头列2 | 表头列3 |
| :-----| ----: | :----: |
| 一行一列 | 一行二列 | 一行三列 |
| 二行一列 | 二行二列 | 二行三列 |

效果如下:

表头列1 表头列2 表头列3
一行一列 一行二列 一行三列
二行一列 二行二列 二行三列

推荐使用Typora:在Typora中则不需要全部打出来、只需打出第一行表头,便可以直接设置表格的对齐方式、增加新的一行或一列

13、高级技巧

13.1、转义符

使用\可以对符号进行转义

没转义效果:**我是没转义效果**

转义效果:\*\*我是转义效果\*\*

效果如下:


没转义效果:我是没转义效果

转义效果:**我是转义效果**

**转义后文本不加粗了,显示*号,一些情况下我们需要这些符号显示出来,就需要使用到\进行转义

13.2、公式

使用$$公式$$进行标记便能显示公式,推荐使用Typora,只需要输入$$+回车就可以编写公式了

$$

a_n = a_1q^{n-1}= \frac {a_1}{q} \cdot q^n(n \in N^*) \\
其中前 n 项的和公式为:\\
S_n =
\begin{Bmatrix}
\frac {a_1 \cdot (1-q^n)}{1-q} &,q \neq 1 \\
na_1 &,q=1
\end{Bmatrix}

$$

效果如下:


a_n = a_1q^{n-1}= \frac {a_1}{q} \cdot q^n(n \in N^*) \\ 其中前 n 项的和公式为:\\ S_n = \begin{Bmatrix} \frac {a_1 \cdot (1-q^n)}{1-q} &,q \neq 1 \\ na_1 &,q=1 \end{Bmatrix}

$$
\begin{Bmatrix}
a & b \\
c & d
\end{Bmatrix}

$$

效果如下:


\begin{Bmatrix} a & b \\ c & d \end{Bmatrix}

$$
\begin{CD}
A @>a>> B \\
@VbVV @AAcA \\
C @= D
\end{CD}
$$

效果如下:


\begin{CD} A @>a>> B \\ @VbVV @AAcA \\ C @= D \end{CD}·

$$
H_2 + O_2 = H_2O
$$

效果如下:


H_2 + O_2 = H_2O

其中_标出下标,^标出上标

如:

H_2

X^2
H_2 \\ X^2

公式方面不做过多的解释,主要是不懂,感兴趣的可以自行查找这一方面的教程


借鉴链接

Markdown 完全入门(上)

Markdown 教程

Markdown 高级技巧

Markdown类图学习

Markdown mermaid种草(7)_ 状态图

mermaid 饼图使用指南


  1. 脚注本注

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容