一、Markdown介绍

Markdown是一种轻量级标记语言，创始人为约翰·格鲁伯（英语：John Gruber）。 它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。——百度百科
Markdown 能被使用来撰写电子书，如：Gitbook。

• 目前网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如：GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。
• 使用Markdown的优点：
  纯文本，兼容性强，可以用所有文本编辑器打开。
  自动排版，让你专注于文字。
  格式转换方便，Markdown 文本可以轻松转换为PDF、html、Word、Epub、图片等。

二、编辑器推荐

1.在线编辑

• StackEdit
  浏览器访问StackEdit
• 简书
  浏览器访问简书
  开启方式：设置->默认编辑器->Markdown编辑器

2.离线编辑

• Typora客户端
  适用于MacOS、Windows、Linux各系统
• Markdown Pad客户端
  适用于Windows系统
• Mou客户端
  适用于Mac系统

三、Markdown基本语法

注意：所有符号均为英文输入法下的符号

1.标题

• 六级标题
  使用#可以表示1~6级标题，1个#表示一级标题，2个#表示二级标题。以此类推。
  注意：#和标题之间最好加上空格。
  语法：

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

  显示效果：

  这是一级标题

  这是二级标题

  这是三级标题

  这是四级标题

  这是五级标题

  这是六级标题

• 大小标题
  ≥3个=可以表示一级标题， ≥3个-可以表示二级标题。
  语法：

  这是一级标题
  ===
  这是二级标题
  ---
  

  显示效果：

这是一级标题

这是二级标题

2.段落格式

• 字体
  Markdown 可以使用以下几种字体：使用*表示斜体文本，**表示粗体文本，***表示粗斜体文本。
  语法：

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

  显示效果：
  斜体文本
  粗体文本
  粗斜体文本
• 分隔线
  可以用三个或三个以上*或-或_表示分隔线，也可以在星号或者减号、下划线之间插入空格。
  语法：

  ***
  ---
  ___
  

  显示效果：

  ---

  ---

  ---

• 删除线
  如果文字需要加上删除线，可以在文字两端各自加两个波浪线~~实现。
  语法：

  ~~删除文本~~
  

  显示效果：
  删除文本
• 下划线
  如果文字需要加下划线，可以用<u>实现。目前简书不支持此语法。
  语法：

  <u>带下划线文本</u>
  

  简书暂不支持下划线，此处不展示效果。

3.列表

Markdown 支持有序列表和无序列表。

• 有序列表
  有序列表用数字加.表示。
  语法：

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

  显示效果：

  1.第一项

  2.第二项

  3.第三项

• 无序列表
  无序列表用*或+或-表示
  语法：

  * 第一项
  - 第二项
  _ 第三项
  

  显示效果：

  • 第一项
  • 第二项
  • 第三项

• 列表嵌套
  在一级列表中嵌套二级列表元素时，需要在嵌套的二级列表之前加四个空格。
  语法：

  1.第一项
      * 第一项嵌套的第一个二级列表
      * 第一项嵌套的第二个二级列表
  * 第二项  
      1.第二项嵌套的第一个二级列表元素
      2.第二项嵌套的第二个二级列表元素
  

  显示效果：
  1.第一项

  • 第一项嵌套的第一个二级列表

  • 第一项嵌套的第二个二级列表

  • 第二项
    1.第二项嵌套的第一个二级列表元素
    2.第二项嵌套的第二个二级列表元素

4.区块引用

• 引用
  段落开头使用 > 符号加一个空格。
  语法：

  > 引用文字
  

  显示效果：

  引用文字

• 区块嵌套
  区块可以嵌套，一个>是最外层，两个>是第一层嵌套，以此类推。
  语法：

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

  显示效果：

  最外层

  第一层嵌套

  第二层嵌套

• 区块中使用列表
  在区块中直接使用列表即可。
  语法：

  > 1.第一项
  > * 第二项
  

  显示效果：

  1.第一项

  • 第二项

• 列表中使用区块
  在列表中使用区块时，需要在>加空格前面加上四个空格。
  语法：

  1.第一项
      >引用文本
  2.第二项
  

  显示效果：

  1.第一项

  引用文本

  2.第二项

5.链接

• 链接使用方法：
  语法：

  [必应](https://cn.bing.com/)
  或者
  <https://cn.bing.com/>
  

  显示效果：
  必应
  或者
  https://cn.bing.com/

• 高级链接
  可以用变量来设置链接，在文档最后进行赋值。
  语法：

    这个链接用 1 作为网址变量 [Bing][1]
    这个链接用 jianshu 作为网址变量 [简书][jianshu]
    然后在文档的结尾为变量赋值（网址）
    ​
     [1]: https://cn.bing.com/
     [jianshu]: https://www.jianshu.com/
  

  显示效果：（ 如下为简书显示结果）
  这个链接用 1 作为网址变量 Bing
  这个链接用 jianshu 作为网址变量 简书
  然后在文档的结尾为变量赋值（网址）

6.图片

• 图片使用方法：
  插入图片与链接方法相似，需要在前面加一个！，表示为：！加[图片替代文字]加(图片网址)。
  语法：

![简书Logo](https://upload-images.jianshu.io/upload_images/24804176-586f83674e86ebe5.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

显示效果：

简书Logo

• 高级图片
  插入图片与链接方法相似，都可以用变量赋值图片网址。
  语法：

  这个链接用 1 作为网址变量 [Can't Breath][1].
  然后在文档的结尾为变量赋值（网址）
  
  [1]:https://images.pexels.com/photos/4677668/pexels-photo-4677668.jpeg?auto=compress&cs=tinysrgb&dpr=1&w=500
  

  显示效果：
  这个链接用 1 作为网址变量 Can't Breath.
  然后在文档的结尾为变量赋值（网址）
  1:https://images.pexels.com/photos/4677668/pexels-photo-4677668.jpeg?auto=compress&cs=tinysrgb&dpr=1&w=500
• 修改图片尺寸
  可以使用Html的<img>标签自定义图片的尺寸。
  语法：

  <img src="htt://example.com/sample.png" width="500" height="350">
  示例：
  <img src="https://images.pexels.com/photos/4677668/pexels-photo-4677668.jpeg" width="500" height="350">
  

  简书暂不支持自定义图片尺寸，此处不展示效果。

7.代码

• 段落内代码
  段落内代码可以用反引号`表示。也可用其进行高亮显示。
  语法：

  `hello world`
  

  显示效果：
  hello world
• 代码区块
  代码前使用四个空格或者制表符Tab。
  语法：

      hello world
    hello world
  

  显示效果：
  hello world
  hello world
• 一段代码
  可以用三个反引号```包裹一段代码。
  显示效果：

  代码段
  

8.表格

表格使用|分隔不同的单元格，-分隔表头和其他行。
表格中用冒号设置对齐方式，:---用来设置单元格左对齐，---:表示右对齐，:---:则为居中对齐。
语法：

|表头1|表头2|表头3|
|:---|:---:|---:|
|A1单元格|B1|C1|
|A2|B2|C2|

显示效果：

四、语法总结

Markdown基础语法总结：