Markdown 语法详解

Markdown简介

ps: 本文Markdown语法均在有道云笔记中测试和修改,不同平台显示有所差异。

Markdown概述

Markdown是一种轻量级的简单易学的标记语言,通过简单的标记语法,可以使普通文本内容具有一定标记格式。其文本格式为.md类似于html,只不过标签更简单,更易读易写,可以方便转换为htmlpdf等格式。
Markdown不是一种编程语言,其目标也不会代替html,但是其非常适用于写文档,书写博客等。一旦上手Markdown后,写作会成为一种享受。

Markdown优点

  • 学习成本低,只需要简单掌握十几个符号用法就可以;
  • 纯文本,兼容性强,所有的文本编辑器都支持;
  • 让用户专注于内容而不是排版;
  • Markdown可以随意转换为htmlpdfmd格式的;
  • 标记语法具有良好的可读性。

    Markdown缺点

  • 对图片的支持度不像word等那么方便;
  • 不同Markdown编辑器语法有细微差别。

Markdown语法

标题

Markdown中插入不同级别的标题操作非常方便,只需要插入不同数量的#即可。

1
2
3
4
5
6
7
8
9
#        一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

注意: #与标题之间一般需要空一格。
备注:以上为Markdown中演示内容,实际书写中呈大小梯度变化。

列表

列表分为有序列表和无序列表,两者在实现上有些差异。有序列表顾名思义是有逻辑数字顺序的,如1、2、3等,而无序列表仅仅是以一种无差异符号表示内容的并列关系。

无序列表

Markdown中支持多种符号实现无序列表格式化,如-*+,其效果均相同。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
---
- aaa
- bbb
- ccc
---
* AAA
* BBB
* CCC
---
+ 111
+ 222
+ 333
---
- aaa # 不同符号之间也可以混用,外观上相同,但间距变大。。。
* BBB
+ 333
---

Markdown下实现效果


  • aaa
  • bbb
  • ccc

  • AAA
  • BBB
  • CCC

  • 111
  • 222
  • 333

  • aaa
  • BBB
  • 333

备注: 因为-符号操作最方便只需要按一下按键,建议最好使用-符号实现无序列表。

有序列表

同等级有序列表

实现同一等级的有序列表,只需要数字加上点号(小数点和英文格式的句号均可以),且与输出的内容中间空一格即可。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
---
---
1. aaa
2. bbb
3. ccc
---
1. aaa
3. ccc
2. bbb
---
111. AAA # 多位数字也可以
112. BBB
113. CCC
---

Markdown下实现效果


  1. aaa
  2. bbb
  3. ccc

  1. aaa
  2. ccc
  3. bbb

  1. AAA
  2. BBB
  3. CCC

多级有序列表

目前,在一般Markdown语法中多等级有序列表没有完美的实现方法,但能通过结合无序列表方法折中解决。

1
2
3
4
5
6
7
8
9
10
11
- 1\. aaa       # 注意'.'前要加反斜杠转义。。。
- 1.1 bbb
- 1.2 ccc
- 2\. bbb
- 2.1 aba
- 2.2 bab
- 3\. ccc
- 3.1 aca
- 3.2 cac
- 3.2.1 eee
- 3.2.2 ggg

Markdown下实现效果

  • 1. aaa
    • 1.1 bbb
    • 1.2 ccc
  • 2. bbb
    • 2.1 aba
    • 2.2 bab
  • 3. ccc
    • 3.1 aca
    • 3.2 cac
      • 3.2.1 eee
      • 3.2.2 ggg

分割线

Markdown中实现分割线也可以通过-*+三种符号完成。具体实现方法如下:

1
2
3
---
------ # 可以使用三个以上符号,*和+ 效果相同
- - - # 符号之间可以加上多个空格

注意: 使用-插入分割线时,需要与上面的内容之间至少空一行,否则 Markdown会将上一行内容解释为二级标题。




字体修饰

Markdown中字体修饰主要包含:字体加粗斜体下划线大小上色背景色等。

字体

Markdown中无原生语法修饰字体,但我们可以借鉴HTML语法实现相关效果。

1
2
3
<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>

我是黑体字
我是微软雅黑
我是华文彩云

字体加粗

Markdown中实现字体加粗方式有以下几种(大家选择顺手的就可以~~~):

1
2
3
4
**加粗**               # 推荐用法
__加粗__ # 英文状态的下划线
<b>加粗</b>
<strong>加粗</strong>

Markdown下实现效果
加粗
加粗
加粗
加粗

  • 字体斜体

Markdown中实现斜体也有以下几种方式:

1
2
3
*斜体*  
_斜体_
<em>斜体</em>

斜体
_斜体_
斜体

下划线

Markdown中并无原生语法的实现下划线,但可以借鉴HTMLcss中的用法。

1
2
3
4
++下划线++     # 有道云中可以实现
<u>下划线</u>
<span style="border-bottom:2px dashed red;">下划线</span>
<span style="border-bottom:2px solid red;">下划线</span>

Markdown下实现效果
++下划线++
下划线
下划线
下划线

字体大小

借鉴HTML语法可以在Markdown中调整字体大小。

1
2
<font size=4>字体大小</font>  
<font size=6>字体大小</font>

字体大小
字体大小

字体上色

借鉴HTML语法也可以在Markdown中实现字体上色效果。

1
2
<font color=gray size=4>字体上色</font>  
<font color=red size=4>字体上色</font>

Markdown下实现效果

字体上色
字体上色

字体背景色

Markdown中也无原生语法的实现下划线,但有道云中可以通过以下方式实现:

1
==字体背景色==    # 有道云中可以,其他平台还未测试

Markdown下实现效果
==字体背景色==

代码

行代码

单行代码引用使用单个符号(符号位于ESC键下方),实现代码着色。Markdown`下实现效果

1
`行代码`,`Markdown`

行代码,Markdown

代码块

将代码置于

1
`Markdown`下实现效果

显示需要,Markdown中不需要加
1
2
3
代码块
代码块
​``` # 显示需要,Markdown中不需要加

1
2
代码块
代码块

引用

Markdown中引用的符号是>,使用时>与引用内容间要空一格。大概可分为普通引用和嵌套引用,具体使用方法如下:

普通引用

Markdown下实现效果

1
2
3
4
5
6
7
> 引用内容1  
引用内容2 # 引用内容后不空行的话,后面均为引用内容,只需要在第一行加上'>'符号即可。
引用内容3

> 引用内容a
> 引用内容b
> 引用内容c

引用内容1
引用内容2
引用内容3

引用内容a
引用内容b
引用内容c

嵌套引用

在引用中加入不同数量的>符号可以表示不同等级。
Markdown下实现效果

1
2
3
> 引用1    #从少到多可以直接实现,如果多到少则不能实现(ps有道云)。
>> 引用2
>>> 引用3

引用1

引用2

引用3

引用内修饰

引用内容内也可以加入字体加粗、代码引用等语法修饰,突出显示内容。
Markdown下实现效果

1
2
3
> **加粗**  
> *斜体*
> `代码`

加粗
斜体
代码

链接

1
2
3
4
[百度](http://www.baidu.com)
[百度](http://www.baidu.com "这是备注") # 可以添加备注
<http://www.baidu.com/> # 自动链接
<fangj@163.com> # 也可以通过链接方式自动生成电子邮件

百度
百度
http://www.baidu.com/
fangj@163.com

图片

Markdown中图片插入的方式与和链接非常相似,差别只是在[]前加上
如果要在网络上分享文章,需要提前将图片放到图床上,获得图片的链接,当然也可以直接在网络上寻找图片。如果只是在本地查看,则可以根据图片相对路径或绝对路径插入到文中。

1
2
![星空](http://seopic.699pic.com/photo/50021/5261.jpg_wh1200.jpg)
![星空](http://seopic.699pic.com/photo/50021/5261.jpg_wh1200.jpg "备注") # 也可以备注信息

星空

参考链接

献给写作者的 Markdown 新手指南
front-end-study from github
Markdown使用笔记
CSDN-markdown编辑器语法——字体、字号与颜色
Learning-Markdown (Markdown 入门参考)

-------------本文结束感谢您的阅读-------------

本文标题:Markdown 语法详解

文章作者:Fangj

发布时间:2018年11月05日 - 09:11

最后更新:2020年04月02日 - 21:04

原始链接:https://biofang.github.io/2018/11/05/Markdown语法详解/

许可协议: 署名-非商业性使用-禁止演绎 4.0 国际 转载请保留原文链接及作者。