markdown 完整语法规范 3.0 + 编辑工具介绍

> 本文由 [简悦 SimpRead](http://ksria.com/simpread/) 转码， 原文地址 [www.cnblogs.com](https://www.cnblogs.com/jonnyan/p/9674504.html)

以下每一种，我都会挑选最常用的一种写法，一切表述只追求简明扼要。想深究，请查看文末链接。

**通用写法:** 符号 + 空格 + 内容

1 引用:
=====

```
单层引用:
> 一级引用
多层引用:内层符号前的空格必须要
> 一级引用
 >> 二级引用

```

### 效果展示:

一级引用

二级引用

2 标题:
=====

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

```

### 效果展示:

一级标题
====

二级标题
----

### 三级标题

...

3 文字加粗:
=======

```
**我是粗体，又黑又粗的那种**

```

### 效果展示:

**我是粗体，又黑又粗的那种**

4 分割线:
======

```
--- 三个或者更多，一般写法是三个(英文字符 3 个横线)。

```

### 效果展示:

5 无序列表:
=======

```
- 无序列表1
- 无序列表2
- 嵌套1       --->嵌套的列表需要一个 Tab 或者 N 个空格(N≥1根据编辑器不同，略有差异。)
 - 嵌套2
   - 嵌套3

```

### 效果展示:

*   无序列表 1
*   无序列表 2
*   嵌套 1
    *   嵌套 2
        *   嵌套 3

6 有序列表:
=======

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

```

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

7 文字链接 (3 种表现方式):
=================

```
1. 直接样式:
    <https://www.cnblogs.com/jonnyan/>
2. 标题样式:
    [点我 余额宝 会多一个亿](https://www.cnblogs.com/jonnyan/)
3. 索引样式:                   ---> 由于 博客园和语雀 均不支持此种写法(编辑器是支持的)，暂不展示效果。
    [哇，你好厉害][1]     --->1 可以是任意字符
    [1]:https://www.cnblogs.com/jonnyan/

```

### 效果展示:

[https://www.cnblogs.com/jonnyan/](https://www.cnblogs.com/jonnyan/)  
[点我 余额宝 会多一个亿](https://www.cnblogs.com/jonnyan/)

8 图片链接 (插图):
============

```
![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

```

### 效果展示:

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADIAAAAyCAYAAAAeP4ixAAACbklEQVRoQ+2aMU4dMRCGZw6RC1CSSyQdLZJtKQ2REgoiRIpQkCYClCYpkgIESQFIpIlkW+IIcIC0gUNwiEFGz+hlmbG9b1nesvGW++zxfP7H4/H6IYzkwZFwQAUZmpJVkSeniFJKA8ASIi7MyfkrRPxjrT1JjZ8MLaXUDiJuzwngn2GJaNd7vyP5IoIYY94Q0fEQIKIPRGS8947zSQTRWh8CwLuBgZx479+2BTkHgBdDAgGAC+fcywoyIFWqInWN9BSONbTmFVp/AeA5o+rjKRJ2XwBYRsRXM4ZXgAg2LAPzOCDTJYQx5pSIVlrC3EI45y611osMTHuQUPUiYpiVooerg7TWRwDAlhSM0TuI+BsD0x4kGCuFSRVzSqkfiLiWmY17EALMbCAlMCmI6IwxZo+INgQYEYKBuW5da00PKikjhNNiiPGm01rrbwDwofGehQjjNcv1SZgddALhlJEgwgJFxDNr7acmjFLqCyJuTd6LEGFttpmkYC91Hrk3s1GZFERMmUT01Xv/sQljjPlMRMsxO6WULwnb2D8FEs4j680wScjO5f3vzrlNJszESWq2LYXJgTzjZm56MCHf3zVBxH1r7ftU1splxxKYHEgoUUpTo+grEf303rPH5hxENJqDKQEJtko2q9zGeeycWy3JhpKhWT8+NM/sufIhBwKI+Mta+7pkfxKMtd8Qtdbcx4dUQZcFCQ2I6DcAnLUpf6YMPxhIDDOuxC4C6djoQUE6+tKpewWZ1wlRkq0qUhXptKTlzv93aI3jWmE0Fz2TeujpX73F9TaKy9CeMk8vZusfBnqZ1g5GqyIdJq+XrqNR5AahKr9CCcxGSwAAAABJRU5ErkJggg==)

9 标签和段落:
========

```
标签:     ---> 反引号(键盘左上角 ESC 按键下方挨着数字 1 的键。)
    `我是内容`
段落:   ---> 第一行后可以指定编程语言，也可以不指定(指定的话，代码会高亮)。
    ```python
        a=1
        if  a > 0:
            print “我学法律的”
        else:
            Print “哎，我也是学法律的，可眼瞅着别人都成了律师，我却成了法师。”
    ```

```

### 效果展示:

`我是内容`

```
        a=1
        if  a > 0:
            print “我学法律的”
        else:
            print “哎，我也是学法律的，可眼瞅着别人都成了律师，我却成了法师。”

```

10 表格:
======

```
产品名称 | 价格
:---: | :---:              --->左冒号表示 左对齐，右冒号表示 右对齐，左右都有表示 居中。
iPhone X|$1600
MacBook|$2400

```

### 效果展示:

<table><thead><tr><th>产品名称</th><th>价格</th></tr></thead><tbody><tr><td>iPhone X</td><td>$1600</td></tr><tr><td>MacBook</td><td>$2400</td></tr></tbody></table>

11 字体 | 字号 | 颜色
===============

```
由于 markdown 本身并不支持字体，字号，颜色的更改，所以需要借助 html 来解决。
<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>哈哈哈哈</font>
<font color=gray size=5>gray</font>
```

### 效果展示:

<font face="黑体">我是黑体字</font>
<font face="微软雅黑">我是微软雅黑</font>
<font face="STCAIYUN">我是华文彩云</font>
<font color=#0099ff size=12 face="黑体">黑体</font>
<font color=#00ffff size=3>哈哈哈哈</font>
<font color=gray size=5>gray</font>

12 markdown 写作工具:
=================

*   以下推荐均支持 Mac | Windows | Linux 平台 (除第一款双平台，第二款 Linux 正在开发中)
*   以下均是从 window 使用角度来介绍 (第一个例外)

1. MarkEditor - [官网链接](https://www.markeditor.com/)
---------------------------------------------------

*   **基础功能免费**，高级功能需付费。
*   MarkEditor 以 markdown 为基础语法，多标签栏、文件夹结构，纯文本的方式带来优雅、高效的体验。 确实很棒的工具，带来很多新鲜的理念，支持、重构、提升 markdown，加快写作的体验。具体可以查看几篇评测文章：
    *   [简洁与强大，从不是矛盾的事物：写作工具 MarkEditor 功能详解](http://sspai.com/34317)
    *   [不止是一款简单的码字工具：MarkEditor 进阶功能介绍](http://sspai.com/34656)

2. YuWriter - [官网链接](https://ivarptr.github.io/yu-writer.site/)
---------------------------------------------------------------

*   **基础功能免费**，高级功能需付费。
*   同上，也是三栏设计，相比上一个优势在于 window 版本上的界面更美观，支持网页复制内容自动转换 markdown 格式，以及导出微信公众号模板。

3. Typora - [官网链接](https://typora.io/)
--------------------------------------

*   **完全免费**
*   不分栏，实时展示看到写出的内容，对于不喜欢「两栏」设计的人来说是一个选择

4. 语雀 - [官网链接](https://www.yuque.com/)
--------------------------------------

*   **完全免费 | 网页端**写法有些区别, 具体可查看[语雀编辑语法](https://www.yuque.com/yuque/help/dive-into-yuque-editor)
*   「语雀」是一个「知识创作工具」，孵化自 蚂蚁金服 ，支持 markdown 格式的文档撰写 + 办公协作，这里我们只介绍 markdown 部分。
*   比其它软件版本多了图片自动外链，思维导图生成，融合了富文本编辑器功能，改字体大小，颜色就非常容易了。
*   [语雀版展示链接](https://www.yuque.com/docs/share/f8134902-d70a-4f38-85f8-93cb2934837c)

### 致谢

*   参考了 [https://blog.csdn.net/qcx321/article/details/53780672](https://blog.csdn.net/qcx321/article/details/53780672)
*   参考了 [https://github.com/xirong/my-markdown](https://github.com/xirong/my-markdown)