简介

MarkDown是一种轻量级标记语言,以纯文本格式编写文档,然后转换成有效的XHTML/HTML内容

  • 语法简洁明了、易读易写
  • 轻量、纯文本、跨平台、兼容性极强
  • 可以转换为HTML/XHTML、EPUB、PDF、Word、纂写Gitbook
  • 广泛使用:
    • Github
    • 简书
    • Typecho
    • WordPress(需编辑器插件)
    • Reddit
    • Diaspora
    • Apollo
    • Moodle
    • more ……
  • 创造者:Aaron SwartzJohn Gruber共同设计

Aaron Swartz(1986年11月8日-2013年1月11日)

MarkDown主要贡献者,Aaron Hillel Swartz(全名)的维基百科介绍为:美国程序员、企业家、作者、政治活动者、互联网黑客主义者,点击查看更多关于这位天才的完整生平

开始使用

  • 编辑器:Typora、Sublime Text、VS code…
  • 首推跨平台、所见即所得的Typora编辑器

标题

一般的,MarkDown使用#可以表示1-6级标题

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题

显示效果:

对于一级和二级标题,还可以使用-和·=来标记

1
2
3
4
这是一级标题
=====
这是二级标题
----------

显示效果:

列表

无序列表

使用-*+来标记无序列表,下面以-为例

1
2
3
- 这是第一项
- 这是第二项
- 这是第三项

显示效果:

  • 这是第一项
  • 这是第二项
  • 这是第三项
有序列表

在阿拉伯数字后面加上.来标记

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

显示效果:

  1. 这是第一项
  2. 这是第二项
  3. 这是第三项
列表嵌套

在子级列表前加4个空格来标记

1
2
3
4
5
6
7
8
9
10
11
12
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
- 第一项嵌套的第三个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素
- 第二项嵌套的第三个元素
3. 第三项:
- 第三项嵌套的第一个元素
- 第三项嵌套的第二个元素
- 第三项嵌套的第三个元素

显示效果:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
    • 第一项嵌套的第三个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素
    • 第二项嵌套的第三个元素
  3. 第三项:
    • 第三项嵌套的第一个元素
    • 第三项嵌套的第二个元素
    • 第三项嵌套的第三个元素

段落

一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的空行,对于大部分现代的MarkDown编辑器(比如Typora),你完全不用关心,写作怎么换行就这么换行就好

反转义

使用反斜杠\使标记符号成为普通符号

可以在以下符号前加上\来标识

  • \ 反斜线

  • ` 反引号

  • * 星号

  • _ 底线

  • {} 花括号

  • [] 方括号

  • () 括弧

  • # 井字号

  • + 加号

  • - 减号

  • . 英文句点

  • ! 惊叹号

字体格式

粗体

使用**__来标记被加粗的文本

**这是被加粗的文本**
__这也是被加粗的文本__

显示效果:

这是被加粗的文本
这也是被加粗的文本

斜体

使用*_来标记倾斜的文本

*这是倾斜的文本*
_这也是倾斜的文本_

显示效果:

这是倾斜的文本
这也是倾斜的文本

粗斜体

使用***___来标记粗斜体文本

***这是一段粗斜体***
___这也是一段粗斜体___

显示效果:

这是一段粗斜体
这也是一段粗斜体

删除线

使用两个~来标记删除线文本

~这是加删除线的文本

显示效果:

这是加删除线的文本

分割线

在单独的一行使用三个或三个以上的*-来标记分割线

***

我被夹在分割线里

***

-–

我被夹在另一条分割线里

-–

显示效果:


我被夹在分割线里



我被夹在另一条分割线里


下划线

使用两个<u>标记添加下划线的文本

<u>这是被下划线标记的文本</u>

显示效果:

这是被下划线标记的文本

脚注

使用[^这是注明的信息]来标记脚注

比如:

这是一段文字^注1

区块引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式

1
>这是一段被引用的内容

显示效果:

这是一段被引用的内容

嵌套引用

> 最外层
> > 第一层嵌套
> > > 第二层嵌套

显示效果:

最外层

第一层嵌套

第二层嵌套

代码区块

短代码

对于短代码,使用`包裹住

比如:printfscanf

代码块

一般的在代码块前使用4个空格或者一个TAB键:

SpaceSpaceSpaceSpace或者TAB

但是比较常用的是使用```包住代码块,在开头的```后还可以标记代码的语言类型,比如:

```JavaScript
$(document).ready(function () {
alert(‘RUNOOB’);
});
```

显示效果为

1
2
3
$(document).ready(function () {
alert('RUNOOB');
});

链接

一般的,MarkDown链接有两种:

[这是链接名称](这是链接地址)

<这是自动链接>

比如:

这是我的博客Spoience的小栈

这是Spoience的小栈https://spoience.top

这是邮箱:example@mail.com

稍微复杂一点的高级链接有点类似于MarkDown的脚注,实际注明的链接类似于脚注在文末引用,比如:

这是[谷歌]2

这是[百度]3

显示效果为:

这是谷歌

这是百度

图片

一般的,引用图片,其中图片标题alt属性文本可以不写

![alt 属性文本](图片地址 “图片标题”)

比如:

![](https://cdn.jsdelivr.net/gh/Spoience/pic/img/20200610222231.jpg)

显示为一张图片

表格

对于最基础的表格,仅仅用到|-来标记表格的基本结构

比如:

|表头1|表头2|
|——–|——–|
|单元格1|单元格2|
|单元格3|单元格4|

显示为:

表头1 表头2
单元格1 单元格2
单元格3 单元格4
在基础的表格功能上,我们还可以使用:-来设置表格的对齐方式
  • -: 设置内容和标题栏居右对齐
  • :- 设置内容和标题栏居左对齐
  • :-: 设置内容和标题栏居中对齐

下面以表格居中为例,比如:

|表头1|表头2|
|:——–:|:——–:|
|单元格1|单元格2|
|单元格3|单元格4|

显示为:

表头1 表头2
单元格1 单元格2
单元格3 单元格4

更多姿势

其实,上面就是MarkDown一般技巧,也是最常使用的。一般的,MarkDown写作最直接转换的就是HTML文本,所以,MarkDown显然也可以支援一些HTML属性,比如:

<kdb> <b> <i> <em> <sup> <sub> <br>

像有些网站的html嵌入代码,有些在MarkDown也是支持的,但不是全部,具体还要看MarkDown的编辑器和渲染器是否支持,像网易云音乐的HTML嵌入代码大部分使用MD解析的程序可以支持。

对于数学公式,MarkDown支持使用两个$$包裹TeXLateXMathjax的数学公式,因为个人使用不是很多,这里不做叙述😛

参考资料