《MarkDown 基础语法》

因为在简书上写文章需要使用到MarkDown,但是我对MarkDown语法不熟,所以写下这一篇《MarkDown 基础语法》以供需要时查阅。正所谓 "纸上得来终觉浅, 绝知此事要躬行"虽然现在网上关于markDown语法的文章有很多，但是我觉得还是应该自己整理一篇以加深印象。此外这既是我第一使用markDown也是第一次写文章，所以各位如果有什么意见或者建议都可以在下方发评论区里评论。
这篇文章暂时就罗列出下面十二块，可能有些内容还没有写到，等用的时候如果发现了一些新内容、细节或者错误我会再对这篇文章进行添加和修改。

一 标题

MarkDown标题有两种写法：

  • 在文本前使用 # 字符
  • 在文本下一行使用等号和减号
  1. 使用 # 标记，可以表示1-6级标题。一级标题使用一个 # 号，二级标题使用两个 # 号，以此类推。也可以在标题文本的前后都加上 # 号，不过文本前的 # 号数量决定标题的级数，文本后的 # 做修饰使用，数量不限。
# 一级标题
# 一级标题 #
# 一级标题 #####

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

一级标题 (26px)

二级标题 (24px)

三级题标 (22px)

四级题标 (20px)

五级题标 (18px)
六级题标 (16px)
  1. 使用 等号(=) 和 减号(-) 标记一级和二级标题，任何数量的 等号(=)和减号(-)都可以有效果
一级标题
=
一级标题
=======

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

一级标题 (26px)

二级标题 (24px)

二 分隔线 删除线 下划线

  1. 分隔线有如下三种写法(可以在星号减号或是下划线中间插入空格, 但是同一行不能有其他内容，空格除外)：
  • 在同一行中使用三个以上的 * 号
  • 在同一行中使用三个以上的 减号 (-) 注：要在减号中间加入空格，不然会被解析成二级标题
  • 在同一行中使用三个以上的 下划线线(shift + -) 注：输入法要切换成英文输入状态
测试文本
***
测试文本
- - -
测试文本
___

测试文本（星号）

测试文本（减号）

测试文本（下划线）

  1. 删除线
  • 在需要删除的文字的两端加上两个波浪线 ~~ 即可
~~测试文本~~
这是一个阳光明媚的~~早晨~~

测试文本
这是一个阳光明媚的早晨

  1. 下划线
  • 下划线可以通过 HTML 的 <u> 标签来实现(但是本站好像不支持)
<u>测试文本</u>

<u>测试文本</u>

三 脚注(脚注是对文本的补充说明)

  • 脚注的格式 [^要注明的文本] (悬停会有完整的信息展示，但是本站好像不支持)
今天天气很好[^测试]

今天天气很好[^测试]

四 字体样式(斜体 粗体 粗细体)

  1. 斜体(在文本前后都加上 * 号 或者 _ 注：符号都只能加一个且符号与文本之间不能有空格)
*斜体文本*
_斜体文本_

测试文本
测试文本

  1. 粗体(在文本前后都加上两个 * 号 或者两个 _ 注：符号都只能加一个且符号与文本之间不能有空格 )
**粗体文本**
__粗体文本__

粗体文本
粗体文本

  1. 粗斜体(在文本前后都加上三个 * 号 或者三个 _ 注：符号都只能加一个且符号与文本之间不能有空格 )
***粗斜体文本***
___粗斜体文本___

粗体文本
粗体文本

五 列表(有序列表 无序列表 嵌套列表)

  1. 有序列表(数字加上点符号) 可有时我们会出现这样的情况，首行内容是以日期或数字开头：2019. 公司年度总结。
    为了避免也被转化成有序列表，我们可以在"."前加上反斜杠（转义符）：2017. 公司年度目标。
1. 第一项
2. 第二项
3. 第三项
4\. 第三项
  1. 第一项
  2. 第二项
  3. 第三项
2019. 公司年度总结
2019\. 公司年度总结

 2019. 公司年度总结
2019. 公司年度总结

2.无序列表(在文本前使用星号(*)、加号(+)或是减号(-)作为列表标记)(注：三种符号可以混用，但是间距比较大而且符号与文本之间必须要有一个空格)

* 第一项
* 第二项
+ 第三项
- 第四项
  • 第一项
  • 第二项
  • 第三项
  • 第四项
  • 第五项
  • 第六项
  1. 嵌套列表(列表嵌套只需在子列表中的选项添加四个空格即可) (示例依次是：有序套无序，无序套无序，无序套有序)
1. 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第一个元素
3. 第三项：
    第二项嵌套的第一个元素
    第二项嵌套的第一个元素
  1. 第一项：
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项：
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第一个元素
  3. 第三项()：
    第二项嵌套的第一个元素
    第二项嵌套的第一个元素
* 第一项：
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
* 第二项：
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第一个元素
  • 第一项：
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  • 第二项：
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第一个元素

* 第一项：
    1. 第一项嵌套的第一个元素
    2. 第二项嵌套的第二个元素
  • 第三项：
    1. 第三项嵌套的第一个元素
    2. 第三项嵌套的第二个元素

六 区块(区块 区块嵌套 区块中使用列表 列表中使用区块)

  1. 区块引用是在段落开头使用 大于符(>) 符号 ，然后后面紧跟一个空格符号，第二行使不使用大于符(>)都可以
> 测试文本

测试文本

> 测试文本1
> 测试文本2

> 测试文本1
测试文本2

测试文本1
测试文本2

测试文本1
测试文本2

  1. 区块嵌套 大于符(>) 符号是最外层，两个大于符(>) 符号是第一层嵌套，以此类推
> 第一层1
> 第一层2
>> 第二层
>>> 第三层

第一层1
第一层2

第二层

第三层

  1. 区块中使用列表
> 区块中使用列表
> 区块中使用列表
> 1. 第一项
>    * 第一项子项一
>     * 第一项子项二
> 2. 第二项
> * 第一项
> * 第二项

区块中使用列表

  1. 第一项
    • 第一项子项一
    • 第一项子项二
  2. 第二项
  • 第一项
  • 第二项
  1. 列表中使用区块(如果要在列表项目内放进区块，那么就需要在 大于符(>) 前添加四个空格的缩进。如果没有缩进的话区块和列表就显示为同一级)
* 第一项
    > 菜鸟教程
    > 学的不仅是技术更是梦想
* 第二项
    > 菜鸟教程
    > 学的不仅是技术更是梦想
  • 第一项

    菜鸟教程
    学的不仅是技术更是梦想

  • 第二项

    菜鸟教程
    学的不仅是技术更是梦想

七 代码(单行代码 代码块)

  1. 单行代码，如果是段落上的一个函数或片段的代码可以用反引号把它包起来（）condole.log()` 函数
  2. 代码块
  • 使用 ``` 包裹一段代码，并指定一种语言（也可以不指定, 指定之后可以识别语言，代码和语法高亮）
```html
    <div>Syntax Highlighting</div>

$(document).ready(function () {
    console.log('测试文本');
});

$(document).ready(function () {
    console.log('测试文本');
});
  • 代码区块使用 4 个空格或者一个制表符(注：没试出来效果)

八 链接(链接 高级链接)

  1. 链接 
    展示中文标题 
语法：[链接名称](链接地址)
[百度](https://www.baidu.com)

不展示中文标题
语法：<链接地址>
<https://www.baidu.com>

    百度
    https://www.baidu.com

  1. 高级链接(定义变量保存链接地址) 
    定义变量语法：[链接的名字]: 链接的地址
使用的语法: [百度][链接的名字]

例如：
  [baidu]: https://www.google.com/
  [百度][baidu]

     百度

九 图片

  1. 直接使用(直接使用自带的插入图片更方便) 
    语法：![图片标题](图片地址 "悬停提示 img标签alt属性效果")
![测试.jpeg](https://upload-images.jianshu.io/upload_images/18865456-b1dbf71b247b27f9.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 '测试.jpeg')

开头一个感叹号 !
接着一个方括号，里面放上图片的标题
接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 'title' 属性的文字。
测试.jpeg
  1. 高级链接(定义变量保存链接地址) 
    定义变量语法：[变量名]: 图片的地址
使用的语法: ![图片标题][变量名]

例如：
  [img]: https://upload-images.jianshu.io/upload_images/18865456- b1dbf71b247b27f9.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 
  '测试.jpeg'
   ![测试][img]
测试.jpeg

十 表格 (基本表格 设置对齐方式)

  1. 基本表格
    制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行, - 数量不限，空格可有可无
|姓名|年龄|性别|
|---|---|---|
|张三|17|男|
|李四|22|女|
姓名 年龄 性别
张三 17 男
李四 22 女
  1. 设置对齐
    -: 设置内容和标题栏居右对齐。
    :- 设置内容和标题栏居左对齐。
    :-: 设置内容和标题栏居中对齐。
| 姓名 | 年龄 | 性别 |
| -: | :- | :-: |
| 张三 | 17 | 男 |
| 李四 | 22 | 女 |
姓名 年龄 性别
张三 17 男
李四 22 女

十一 换行

可以使用</br>标签

测试<br />文本

测试<br />文本

十二 转义

在符号前插入反斜杠()来插入一些在语法中有其它意义的符号

*测试文本*
\*测试文本\*
+ 加号 
\+ 加号

测试文本
*测试文本*

  • 加号
    + 加号

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\反斜杠  
`反引号  
*星号  
_下划线  
{}花括号  
[]方括号  
()括弧  
#井字号  
+加号  
-减号  
.英文句 
!感叹号
©著作权归作者所有,转载或内容合作请联系作者
平台声明：文章内容（如有图片或视频亦包括在内）由作者上传并发布，文章内容仅代表作者本人观点，简书系信息发布平台，仅提供信息存储服务。

推荐阅读更多精彩内容

  • Markdown 基础语法
    A、目录 1、斜体和粗体 2、分级标题 3、超链接3.1、行内式3.2、参考线3.3、自动链接 4、锚点 5、列表...
    侯工阅读 987评论 2赞 7
  • Markdown 基础语法
    Markdown语法总结 一.标题 1. 两个= 或者两个- 对应1、2阶标题 对应效果： This is an ...
    WillBetterMan阅读 723评论 0赞 0
  • Markdown基础语法
    Markdown 简介 Markdown 是一种用来写作的轻量级标记语言, 用一些简单的标记, 来代替常见的排版格...
    高小原阅读 484评论 0赞 0
  • Markdown基础语法总结
    目录 区块元素标题列表区块引用代码区块分隔线段落和换行 区段元素链接强调代码图片转义 标题 类SetextTh...
    ting723阅读 28,239评论 2赞 32
  • Markdown基础语法
    本文转自@younghz 主要内容 Markdown是什么？谁发明了这么个东西？为什么要使用它？怎么使用？都谁在用...
    Wynter_Wang阅读 458评论 0赞 1