MarkDown介绍

阅读指引

本文综合博主学习使用MarkDown的经验，对MarkDown做一个系统性介绍。

（重要信息会加粗，以节约阅读者时间）

阅读本文能给你带来什么：

明白MarkDown是什么
优点
缺点
什么时候适合使用MarkDown
如何使用

MarkDown是什么

Markdown是由约翰·格鲁伯（John Gruber）和亚伦·斯沃茨（Aaron Swartz）发明的一种轻量级的「标记语言」。使用这种标记语言撰写的文本，能被转换为HTML在Web上发布，并以结构化的效果展现。

Markdown 的目标是实现「易读易写」。

优点

Markdown把作者从繁杂的排版工作中解放出来，实现易读易写的文章写作，已经逐渐成为事实上的行业标准。

语法简洁明了、学习容易
使用极其简单，文档快速排版

缺点

复杂格式支持不完善
有多家扩展语法，扩展语法相互兼容并不友好
不同编辑器渲染结果有较大差异

什么时候适合使用MarkDown

博主个人经验总结建议：

建议使用：编辑纯文本内容时使用（可包含超链接，不包含图表）

不建议使用：当排版复杂、精细，对于缩进，间距等展示有较高要求，包含图表内容等情形

使用场景总结：纯文本、排版简洁、无复杂排版要求

如何使用

使用编辑器写作过程中，直接使用其语法既可

纯文本编辑器：可直接编辑，但无法直接查看渲染结果

MarkDown编辑器：MarkDown编辑器一般支持实时编辑，实时显示渲染结果

windows平台推荐：MarkdownPad

mac平台推荐：MacDown

其他编辑器：笔记类软件、在线博客平台

基本语法介绍

标题

在 标题下 加上任意个=代表一级标题，-代表二级标题

一级标题
======

二级标题
----------

在 标题开头 加上1~6个#，依次代表一级标题、二级标题....六级标题

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

列表

无序列表使用-、+和*作为列表标记

- first
- second
- three

* first
* second
* three

+ first
+ second
+ three

有序列表使用数字加英文句点.来表示

1. first
2. second
3. three

强调(粗体、斜体、删除)

两个*或-代表加粗，一个*或-代表斜体，~~代表删除

**加粗文本** 或者 __加粗文本__

*斜体文本*  或者_斜体文本_

~~删除文本~~

换行（直接Enter不会换行）

在行尾添加两个空格+回车表示换行

分隔线

在一行中用三个以上的*、-、_来建立一个分隔线，行内不能有其他东西

***
---
___

代码

行内代码使用 `代码` 标识，可嵌入文字中

这是行内代码`onCreate`的例子

代码块使用4个空格或```标识

```
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}
```
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

图片与链接

图片：![]()    ![图片文本(可忽略)](图片地址)

链接：[]()     [链接文本](链接地址)

其他

其他语法请参考

https://www.markdownguide.org/

本文参考

https://www.imooc.com/article/12063

https://blog.csdn.net/youmingyu/article/details/53101627

https://baike.baidu.com/item/markdown/3245829?fr=aladdin

http://www.markdown.cn/