《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 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:

\反斜杠  
`反引号  
*星号  
_下划线  
{}花括号  
[]方括号  
()括弧  
#井字号  
+加号  
-减号  
.英文句 
!感叹号
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,817评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,329评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,354评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,498评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,600评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,829评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,979评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,722评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,189评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,519评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,654评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,329评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,940评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,762评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,993评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,382评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,543评论 2 349

推荐阅读更多精彩内容

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