作者 李明明
转载请注明出处： http://limingming.org/index.php/2018/11/28/markdown-grammar/
介绍
Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，然后转换成格式丰富的HTML页面。 —— 维基百科;
Markdown 是一种轻量级标记语言，让写作者专注于写作而不用关注样式。很多有编程基础的程序员比较喜欢使用Markdown进行编写，github项目中README.md都是markdown编写的；以下我讲述通用的语法，保留各个编辑器通用的，还有很多markdown语法是各个编辑器独有的，大家使用过程中可以注意一下，平时使用mac上的编辑器,也为大家分享一下。
语法介绍
标题
一级标题
二级标题
三级标题
演示图效果：
强调
- 在Markdown中，可以使用 * 或 _ 来表示斜体和加粗。
- 使用一个或者_来表示斜体，两个或者_来表示加粗。
A： *我是斜体*
B: _我也是斜体_
C：**我是粗体**
D: __我也是粗体__
演示图效果：
- image.png
- 例子（摘抄于马克飞象"案例，马克飞象是一个很不错的markdown编辑器，为markdown各种类型的语法提供了一个良好的支持）
**马克飞象**是一款专为印象笔记（Evernote）打造的Markdown编辑器，通过精心的设计与技术实现，配合印象笔记强大的存储和同步功能，带来前所未有的书写体验。特点概述：
- **功能丰富** ：支持高亮代码块、*LaTeX* 公式、流程图，本地图片以及附件上传，甚至截图粘贴，工作学习好帮手；
- **得心应手** ：简洁高效的编辑器，提供[桌面客户端][1]以及[离线Chrome App][2]，支持移动端 Web；
- **深度整合** ：支持选择笔记本和添加标签，支持从印象笔记跳转编辑，轻松管理。
锚点
markdown会针对每个标题，在解析时都会添加锚点 id，例如：
# 介绍
# 介绍1
那我们就可以使用“[访问介绍标题的锚点](#介绍)”,来定义锚点
测试：
访问介绍标题的锚点;
引用
Markdown 标记区块引用和 email 中用 『>』的引用方式类似，只需要在整个段落的第一行最前面加上 『>』 ：
> 我是引区的内容，原来一直在CSDN编写博客[我的博客](https://blog.csdn.net/limm33)
我的微信公众号:[编程者联盟](https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
我的 [个人博客](http://www.limingming.org)
我的QQ群：115402375
演示：
列表
标记通常放在句子最左边，项目标记后面要接一个字符的空格。
- 无序列表：使用星号、加号或是减号作为列表标记
* 我是无序列表A
+ 我是无序列表B
- 我是无序列表C
- 有序列表：使用数字接着一个英文句点
1. 我是无序列表1
2. 我是无序列表2
3. 我是无序列表3
3.代办列表(简书暂不支持此方式）
- [ ] 不勾选
- [x] 勾选
- 补充
如果在列表中使用引用,需要换行缩进，一般为四个空格：
* 演示内容：
> 引用部分1
> 引用部分2
> 引用部分3
> 引用部分4
代码块
使用`包裹代码块，并声明代码块的语言，一般会带有相关的解析插件，对代码进行高亮处理，对代码进行着色。
```java
if (!chatBotMap.containsKey(sessionId)) {
chat = aimlBot.setChat(sessionId);
chatBotMap.put(sessionId, chat);
answer = chat.multisentenceRespond(request);
} else {
chat = chatBotMap.get(sessionId);
answer = chat.multisentenceRespond(request);
}
```
演示：
超链接
方括号显示说明，圆括号内显示网址， Markdown 编辑器会自动把它转成链接；
[我的博客](https://blog.csdn.net/limm33)
[编程者联盟](https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
[个人博客](http://www.limingming.org)
演示：
图片
图片和超连接语法比较像，可以在方括号前面加一个！就变成了引用图片了；
或者：
相对路径也可以(./path/*.jpg)这种形式
分割线
使用 3 个以上 - 符号制作分割线：
分割线以上内容
------------------
分割线以下内容
演示：
表格
markdown可以制作表格，方法也很简单
例如：
3 | 3 | 3
-|-|-
3| 3| 3
以上为最基本的结构，‘3’代表你编辑的内容，第一行为表头，但是有的编辑器 - 需要多个，有的需要至少三个，所以布局可以尽量美观：
一列 | 第二列 | 第三列
---------|---------------|----------
值1 | 值2 | 值3
演示：
可以设置对齐方式,使用 ：添加在列的左边左对齐，右边为右对齐，两边都添加就是中间对齐：
一列 | 第二列 | 第三列
:---------|---------------:|:----------:
值1 | 值2 | 值3
值3 | 值4 | 值5
演示：
以上为总结的markdown的语法，希望对你的编写有所帮助。
