Markdown语法

Markdown语法

二月 13, 2019

认识Makedown

Makedown是一种标记语言,大多数人第一个会想到Html,他就是一种标记语言(HTML应该是一种超文本标记语言,所谓超文本标记语言就是指文本中可以包含图片音乐、链接等非文字的元素,又称富文本,但是本质依然是一种标记语言)。所谓标记语言就是用特定的标识符对一段文字进行标记,从而实现使用者对文字的排版,而在此之前,我们实现文字排版大部分都是使用其他工具(WPS、World、Pages)等实现,但是不免存在一些弊端:

  1. 需要安装一个重量级的工具,不管时World、Pages还是WPS,安装起来都非常占用空间。
  2. 有些正版工具非常昂贵,盗版工具体验差(支持正版)。
  3. 工具版本不同,文本排版时可能会有些差别,也就是用World写一个文本,再用WPS打开有时会出现一些诸如排版、字体大小、行间距等等不一致的情况。

针对以上问题,标记性语言可以解决,他所具有的有点有:

  1. 轻量级,甚至已经有多款在线的makedown编辑工具也非常好用。
  2. 完全免费。
  3. 兼容性好,GitHub、CSDN、简书等网站均支持Markdown语法,不存在版本显示的问题。

语法简介

标题

在你想要设置标题的文字前面添加#,一个#是一级标题,两个#是二级标题,以此类推:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:
titel


字体

加粗
在要加粗的文字左右两边分别用两个*包起来。
斜体
在要倾斜的文字左右两边分别用一个*包起来。
斜体加粗
在要斜体和加粗的文字左右分别用三个*包起来
删除线
在要贾删除线的文字左右两边分别用两个~号包起来。
示例:

1
2
3
4
*这是斜体文字*
**这是加粗文字**
***斜体加粗文字***
~~这是删除线文字~~

效果:
这是斜体文字
这是加粗文字
这是斜体加粗文字
这是删除线文字


引用

在引用的文字前面加>即可。引用也可以嵌套,例如加两个 >> 三个 >>> n个…
示例:

1
2
3
>这是引用内容
>>注意,前方高能!
>>>>>>>>>>高能~

效果:

这是引用内容

注意,前方高能!

高能~


分割线

三个或者三个以上的 - 或者 * 都可以
示例:

1
2
-----
***

效果:



图片

语法:

1
2
3
![图片alt](图片的地址 ''图片titel'')
图片alt就是显示在图片下面的文字,一般是对图片的内容进行解释
图片的titel就是图片的标题,当鼠标移动到图片上时显示的内容,titel可要可不要

示例:

1
![我是图片alt](/img/rainbow.png '我是titel')

效果:
'我是图片alt'

markdown在插入图片时,默认图片靠左,有些时候我们想要设置图片居中,或者靠右就可以使用下面程序:

1
2
<div align=center>![这里写图片描述](http:...)
<div align=right>![这里写图片描述](http:..)

实例:

  1. 图片居中

    1
    <div align=center>![图片居中](/img/rainbowico.png)
  2. 图片靠右

    1
    <div align=center>![图片靠右](/img/rainbowico.png)

效果:

  1. 图片居中
    图片居中
  2. 图片靠右
    图片居中

图片大小,有两种设置方法,一种是直接设置图片大小,另一种是输入缩放图片缩放百分比:

1
2
<img src="http:..." width = "100" height = "100" div align=right />
<img src="http:..." width = 30% height = 30% />

实例:

  1. 图片大小为50x50

    1
    <img src="/img/rainbowico.png" width = "100" height = "100" div align=right />
  2. 图片扩大20%

    1
    <img src="/img/rainbowico.png" width = 20% height = 20% />

效果:

  1. 图片大小为50x50

  2. 图片扩大20%


超链接

语法:

1
2
[超链接名](超链接地址, '超链接title')
跟图片类似title可加可不加

示例:

1
2
[Github](https://github.com)
[!404](https://google.com)

效果:
Github
!404

注意:
Markdown本身语法不支持链接在新页面打开,如果想要在新页面打开链接的话可以使用html语言的a标签代替

1
<a href="超链接地址" target="_blank">超链接名</a>

示例:

1
<a href="https://github.com/RainBowAurora" target="_blank">我的github</a>

效果:
我的github


列表

  • 无序列表
    语法:
    无序列表用-+\*任何一种都可以
    1
    2
    3
    4
    5
    - 列表内容1
    + 列表内容2
    * 列表内容3

    注意: - + * 跟内容之间都有一个空格

效果:

  • 列表内容1
  • 列表内容2
  • 列表内容3

  • 有序列表
    语法:
    文字前数字加点

    1
    2
    3
    1. 列表内容1
    2. 列表内容2
    3. 列表内容3

效果:

  1. 列表内容1
  2. 列表内容2
  3. 列表内容3
  • 列表嵌套
    上一级和下一级之间加三个空格即可
  • 一级无序内容
    • 二级无序内容
    • 二级无序内容
    • 二级无序内容
  • 一级无序内容
    1. 二级有序内容
    2. 二级有序内容
    3. 二级有序内容
  1. 一级有序内容
    • 二级无序内容
    • 二级无序内容
    • 二级无序内容
  2. 一级有序内容
    1. 二级有序内容
    2. 二级有序内容
    3. 二级有序内容

表格

语法:

1
2
3
4
5
6
7
8
9
10
表头|表头|表头
----|:--:|----:
内容|内容|内容
内容|内容|内容

第二行分割表头和内容
`-` 一个就够了,有时为了对齐可以多加几个
文字默认居左
`:-:`文字居中
`-:`居右

示例:

1
2
3
4
5
姓名|性别|年龄
----|:--:|--:
六六|女|28
壮壮|男|25
花花|男|30

效果:

姓名 性别 年龄
六六 28
壮壮 25
花花 30

注意:
在编写表格的时候,表头之前因该空一行,否则表格不会正常显示。


代码

语法:
单行代码:代码之间分别用一个反引号扩起来

1
`单行代码`

代码块:代码之间用三个反引号扩起来,并且反引号独占一行

1
2
3
4
5
(```)
代码 ...
代码 ...
代码 ...
(```)

注意:
为了防止转译,上述的代码块中的三个反引号添加了小括号(),在正常使用的时候没有小括号,这里只是为了演示。

示例:

  1. 单行代码

    1
    `#include <iostream>`
  2. 代码块

    1
    2
    3
    4
    5
    6
    7
    8
    (```)
    #include <stdio.h>
    int main(int argc, char *argv[])
    {
    printf("Hello world~!");
    return 0;
    }
    (```)

效果:

  1. 单行代码
    #include <iostream>
  2. 代码块
    1
    2
    3
    4
    5
    6
    #include <stdio.h>
    int main(int argc, char *argv[])
    {
    printf("Hello world~!");
    return 0;
    }

代办事项

代办事项和清单,在Markdown中,你住需要在代办的事项文本或者清单文本前面加上-[]即可.

语法:

  • 表示未完成
  • 表示已经完成

试例:

1
2
3
- [x] 分析需求
- [ ] 研发
- [ ] 测试

效果:

  • 分析需求
  • 研发
  • 测试

转义符

在markdown文档一般无法直接中输出被用于传唤格式的符号本身,通常需要用到转义符,也就是\来协助:
如果要显示*,则可使用如下方式:

1
/*

常用的转义符号有:

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
` 反引号
\* 星号
\_ 下划线
{} 花括号
[] 方括号
() 圆括号
# 井号
+ 加号
- 减号(连字符)
. 句点
! 感叹号

缩进

在没一行开头的时候输入下面的代码,然后跟着输入文本即可.注意分号!
语法:
半角空格: &ensp;&#8194;
全角空格: &emsp;&#8195;
不换行空格: &nbsp;&#160;
示例:

1
2
3
4
正常文本
&ensp;&#8194;半角空格缩进
&emsp;&#8195;全角空格
&nbsp;&#160;不换行空格

效果:
正常文本
  半角空格缩进
  全角空格
  不换行空格


参考网址

参考:
https://www.jianshu.com/p/b421cc723da5
https://www.jianshu.com/p/191d1e21f7ed
https://www.jianshu.com/p/335db5716248
https://www.zybuluo.com/mdeditor?url=https://www.zybuluo.com/static/editor/md-help.markdown#cmd-markdown