MarkDown简明教程

简介

MarkDown是一种轻量级标记语法，这种语法利用特殊的文本字符来标识某种样式，让写作者在写作的时候可以全身心的关注内容，而不需要太关心文章格式。当写作完成后可以将MarkDown文件转换成HTML、PDF、图像、Epub等多种通用格式的文档。可以说MarkDown是写博客的利器。

比如说，MarkDown语法中使用两个**来标识加粗的样式。我们在书写时只需要写成

我是一段文本，这里需要**加粗**。

经过MarkDown渲染后就是下面的效果

我是一段文本，这里需要加粗。

MarkDown由Aaron Swartz和John Gruber共同设计。Aaron Swartz就是那位在 2013年1月11日自杀，有着开挂一般人生经历的程序员。维基百科对他的介绍是：软件工程师、作家、政治组织者、互联网活动家、维基百科人。

他有着足以让你跪拜的人生经历：

• 14岁参与RSS 1.0规格标准的制订。
• 2004年入读斯坦福，之后退学。
• 2005年创建Infogami，之后与Reddit合并成为其合伙人。
• 2010年创立求进会（Demand Progress），积极参与禁止网络盗版法案（SOPA）活动，最终该提案被撤回。
• 2011年7月19日，因被控从MIT和JSTOR下载480万篇学术论文并以免费形式上传于网络被捕。
• 2013年1月自杀身亡。

优点
使用Markdown有很多优势。

• Markdown这种标记语言可以非常方便的排版文章同事适配各大写作网站，这种沉浸式的写作体验让你专注于写作而不是纠结于排版（想想word的写作体验）；
• Markdown是纯文本的格式，比较轻量级，而且文本文件在各个平台（操作系统）上都能顺利打开；
• 可以非常方便地转换成HTML、PDF、图像、Epub等多种通用格式；
• 和HTML一样，Markdown也是一种标记语言，但是和HTML比起来，MarkDown更加易于书写，可读性也更高。

缺点

• 由于MarkDown中的标记符号都是英文字符，所以如果你是用中文在写作的话需要经常切换输入法，比较麻烦。老外在设计MarkDown的时候只考虑到自己，有点“自私”，哈哈；
• 支持的格式不够全，MarkDown支持的格式没有Word这种软件那么全。比如说原生MarkDown中的表格就不支持跨多行。

下面来介绍下MarkDown的简明用法。

MarkDown语法

MarkDown的语法非常简单，学习成本比较低。这也许也是MarkDown比较流行的一个原因。

标题语法

1、使用 = 和 - 标记一级和二级标题

我展示的是一级标题
=================

我展示的是二级标题
-----------------

但是这种格式的标题最多只能显示两级标题，平时我们用的比较多的还是下面介绍的#形式的标题。

2. 使用 # 号标记

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

段落字体语法

Markdown 段落没有特殊的格式，直接编写文字就好。段落的换行是使用两个以上空格加上回车。你也可以使用一个空行来表示开启一个新段落。

字体相关语法

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

显示效果如下：

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本

分割线相关语法

***
* * *
*****
- - -
----------

效果如下：

---

---

---

---

---

删除线相关语法

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 。

~~程序员自由之路~~

显示效果如下：

程序员自由之路

下划线语法

<u>程序员自由之路</u>

显示效果如下：

程序员自由之路

标注语法

程序员自由之路[^slogan]

显示效果如下：

程序员自由之路^[1]

列表语法

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记

* 程序员自由之路1
+ 程序员自由之路2
- 程序员自由之路3

显示效果

• 程序员自由之路1
• 程序员自由之路2

• 程序员自由之路3

有序列表使用数字并加上 . 号来表示。

1. 程序员自由之路1
2. 程序员自由之路2
3. 程序员自由之路3

显示效果如下

1. 程序员自由之路1
2. 程序员自由之路2
3. 程序员自由之路3

有序列表和无序列表之间可以嵌套

1. 程序员1
    - 自由之路1
    - 自由之路2
2. 程序员2
	- 自由之路3
	- 自由之路4

显示效果如下：

1. 程序员1
   • 自由之路1
   • 自由之路2
2. 程序员2

• 自由之路3
• 自由之路4

引用语法

MarkDown中使用>来表示引用。

> 事实表明，执着的程序员更容易成功~

显示效果如下：

事实表明，执着的程序员更容易成功~

代码语法

MarkDown中一般使用一对```来表示代码块。同时在```旁边还可以指定代码具体是属于什么语言。

```java
public class Hello{
public static void main(String[] args){
System.out.println("Hello World...");
}
}
```

显示效果如下：

public class Hello{
    public static void main(String[] args){
        System.out.println("Hello World...");
    }
}

链接语法

MarkDown中链接的语法如下

[连接名称](链接地址)
<连接地址>

显示效果如下：

欢迎访问我的个人网站程序员自由之路

欢迎访问我的个人网站<www.chensongxia.cn>

MarkDown也支持文内跳转语法，一般通过HTML标签完成。

欢迎阅读自由之路写的代码

图片语法

MarkDown中的图片语法如下

![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")

我们可以使用img标签来使用更高级的图片样式。

<img src="line" width="50%" >

表格语法

MarkDown的表格语法如下：

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

显示效果如下：

表头	表头
单元格	单元格
单元格	单元格

我们可以设置表格的对齐方式：

• -: 设置内容和标题栏居右对齐。
• :- 设置内容和标题栏居左对齐。
• :-: 设置内容和标题栏居中对齐。

| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

显示效果如下：

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

HTML元素

目前MarkDown支持的HTML元素：<kbd> <b> <i> <em> <sup> <sub> <br>等。

参考

• https://blog.csdn.net/weixin_44049566/article/details/89513771
• https://www.runoob.com/markdown/md-tutorial.html
• https://www.zhihu.com/question/19963642
• https://blog.csdn.net/weixin_43189735/article/details/84317145
• https://www.zhihu.com/question/19637157
• MarkDown写公众号文章
• 《了不起的Markdown》

---

1. 自由之路上我们携手前行 ↩︎

来源：oschina

链接：https://my.oschina.net/u/4283640/blog/4273292