欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

MarkDown基础语法

程序员文章站 2022-07-14 11:09:19
...

布局:markdown
标题:MarkDown基本语法
日期:2018-04-19 16:10:48

标签:MarkDown Grammr

序言

      有想查看markdown编写出的程序代码标签转化为html标签的可以点击 markdown在线编辑,这是网上一个很好用的在线翻译工具。

起因

       降价流行起来就是因为它简单,更容易理解的解释是,当你想快速写篇丰富格式且又美观的文章或论文,却又不想打开Word中时,你可以用降价,手不离键盘,快速高效。

正文

一、标题

      标题是真是文章的开始,也是目录生成的标志。标题下面是几种编写标题的语法:

方法一:

代码:

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

注意:#后面跟上空格,在编写markdown标签时建议使用方法。

方法二:

代码:

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

注意:与方法一相比,次方法#可以不跟空格,不过为了标签统一性,养成良好的编码习惯,建议加上空格。

方法三:

代码:

一级标题
===
二级标题
--- 

注意:这种方法好像只能表示一级和二级标题,而且=和 - 号的数量没有限制,只要大于一个就行,但是还是为了编码的一直性建议采用三个。
显示效果:
MarkDown基础语法

注意:方法一与方法二标题支持h1-h6,方法三只支持一级标题和二级标题。另外这三种方式的标题可以混合使用,但是为了让页面标签的统一性,不建议混合使用,还是推荐使用第一种。

二、列表

      我们都知道,列表分为有序列表和无序列表,下面主要介绍这两种列表的写法。

1、无序列表

代码:

* 1
* 2
* 3
+ 1
+ 2
+ 3
- 1
- 2
- 3

显示效果:

MarkDown基础语法

语法说明:无序列表可以用(星号、加号、减号)来创建的效果都是一样的,用兴趣的用序言推荐的markdown在线编辑器,可以发现实际上是都转换成了ul>li ,所以使用哪个都可以,推荐使用* 。

2、有序列表

代码:

1. 列表1
2. 列表2
3. 列表3
2. 列表4
1. 列表5

显示效果:

MarkDown基础语法

语法说明:有序列表就相对简单一点,只用1.2.3.就可以实现。
注意:数字后面的点只能是英文的点,特别注意,有序了列表的顺序是根据第一行数字顺序来的 ,对比代码与图形可以看出,代码部分序列排序为1.2.3.2.1.而运行结果图为1.2.3.4.5.,可以看出,列表的顺序是按第一行排序,这点必须注意了。

三、块引用

      对某个部分的内容一些说明或者引用了somebody的话,作品的作者等,可以用区块引用。

1、嵌套引用:

代码:

>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>五级引用
>>>>>>六级引用
>>>>>>>七级引用

显示效果:

MarkDown基础语法

语法说明:想要在上一层引用中嵌套一层引用,只需要多家一个  > ,理论上可以无限嵌套。 注意:多层嵌套的>是不需要连续在一起的,只要在一行就可以了,中间允许有空格,但是为了好看,建议多层嵌套时。控制在一起写

1,嵌套使用:

代码:

> ##名言
> *真理惟一可靠的标准就是永远自
>> ------欧文
> *时间是一切财富中最宝贵的财富。
>> ------德奥弗拉斯多

显示效果:
MarkDown基础语法
可以看出标题也可嵌套在引用中,具体的使用很简单,多写几遍就掌握了。

四、分割线

代码:

分割线1
***
分割线2
---
分割线3
___

显示效果:

MarkDown基础语法

语法说明:分割线可以由(星号,减号,底线)这3个符号的至少3个符号表示,建议用-(减号)。
注意: 至少要三个,且不需要连续,有空格也可以。

五、超链接

      MarkDown支持两种形式的链接语法,行内式链接和参考式两种,行内式一般使用较多。

1、行内式:

代码:

请点击:[百度](http://www.baidu.com)链接。
请点击:[百度](http://www.baidu.com "百度")链接。

显示效果:

请点击:百度链接。
请点击:百度链接。

语法说明:[ ]这里写链接文字,()这里写链接地址,()中的”“中可以为链接指定title的属性,title属性可以不加。title属性的效果是鼠标悬停在连接上会出现制定的title文字。[链接文字](链接地址 ”链接标题“)这样的形式。
注意:链接地址与链接标题前有个空格。链接标题要有英文模式下的”“(引号)。

2、参考式:

      参考式超链接一般用在学术论文上面,或者另一种情况,如果某一个链接在文章中多处使用,那么使用引用的方式创建链接将非常好,它可以让你对链接进行统一的管理。

代码:

我经常去的网站[Google][1]、[百度][2]以及[github][3],[github][3]是一个不错的开原网站。

[1]:http://wwww.google.com "Google链接"
[2]:http://wwww.baidu.com "百度链接"
[3]:https://github.com/ "github链接"

显示效果:

我经常去的网站Google百度以及githubgithub是一个不错的开原网站。

语法说明:参考式链接分为两部分,文中的写法 [链接文字][链接标记],在文本的任意位置添加[链接标记]:链接地址 “链接标题”,链接地址与链接标题前有一个空格。
注意:以上代码符号均用英文输入法写入。如果链接文字本身可以做为链接标记,你也可以写成[链接文字][ ]。

六、自动连接

代码:

<http://wwww.baidu.com>
<aaa@qq.com>

显示效果:

http://wwww.baidu.com
[email protected]

语法说明: Markdown支持以下简短的自动链接形式来处理网址和电子邮件信箱,只要是<>包起来,Markdown就会自动把它转成链接。一般网址的链接文字就和链接地址一样。

七、插入图片

      图片的创建方式与超链接相似,而且和超链接一样也有两种写法,行内式和参考式写法。

1、行内式

夏椅:
![百度](http://yoocii.cn/2018/04/19/Grammar/picture.png

显示效果:
MarkDown基础语法

语法说明:

[图片Alt](图片地址“图片标题“)

2、参考式代码:

夏椅:
![夏椅][desk]
[desk]:http://yoocii.cn/2018/04/19/Grammar/picture.png "夏椅"

显示效果:

夏椅:
MarkDown基础语法
语法说明:

在文档要插入图片的地方写![图片Alt][标记]在文档的最后写上[标记]:图片地址 “Title”

注意:语法中图片Alt的意思是如果图片因为某些原因不能显示,就用定义的图片Alt文字来代替图片。 图片Title则和链接中的Title一样,表示鼠标悬停与图片上时出现的文字。 Alt 和 Title 都不是必须的,可以省略,但建议写上。

八、表格

1、简单方式

代码:

用户姓名|用户性别|用户身高
-|-|-
小明|男|178cm
小红|女|167cm
小强|男|180cm

显示效果:

用户姓名 用户性别 用户身高
小明 178cm
小红 167cm
小强 180cm

 
语法说明:第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。

2、原生方式

代码:

|用户姓名|用户性别|用户身高|
|-|-|-|
|小明|男|178cm|
|小红|女|167cm|
|小强|男|180cm|

显示效果:

用户姓名 用户性别 用户身高
小明 178cm
小红 167cm
小强 180厘米

 
语法说明:比简单方式多加了两边的边框,其他都一样,第一行为表头,第二行分隔表头和主体部分,第三行开始每一行为一个表格行。

3、表格对其方向

用户姓名|用户性别|用户身高
- :| - :| - :
小明|男|178厘米
小红|女|167厘米
小强|男|180厘米

显示效果:

用户姓名 用户性别 用户身高
小明 178cm
小红 167cm
小强 180cm

 
语法说明第二行可以为不同的列指定对齐方向。默认为左对齐,在 - 右边加上:就右对齐。
注意: :(冒号)为英文输入法模式下符号,可以单列使用,使用方式在第二行所选列的 - (减号)后面加:(冒号)。

九、代码框

      这个就比较重要了,很多时候都需要展示出一些代码可以用代码框。

1、单行展示

如果代码量比较少,只有单行的话,可以用单反引号包起来。

代码:

`请点击:[百度(http://www.baidu.com)链接.` 

显示效果:

请点击:[百度(http://www.baidu.com)链接。

注意:。这里是反单引号并不是单引号

2、行多展示

      要是多行这个就不行了,多行可以用三个反引号,如果要写注释,可以在反引号后面写。
代码:

```
降价请点击:[ 百度](http://www.baidu.com )链接。请点击:[ 百度](http://www.baidu.com“百度” )链接```

显示效果:

请点击:[百度](http://www.baidu.com)链接。
请点击:[百度](http://www.baidu.com "百度")链接

注意:如果要写注释,可以在反引号后面写。

十、强调

      强调包括字体倾斜、字体加粗等。

代码:

*字体倾斜*
_字体倾斜_
**字体加粗**
__字体加粗__
***字体倾斜并加粗***
___字体倾斜并加粗___

显示效果:

字体倾斜
字体倾斜
字体加粗
字体加粗
字体倾斜并加粗
字体倾斜并加粗

语法说明:一个星号或者是一个下划线包,会转换为< EM >倾斜,如果是2个,会转换为的< strong >加粗,如果是三个就是倾斜并加粗。

十一、转义

代码:

\\
\〜
\
\
\ \ \ _
\  -
\ +
\。
\!

显示效果:
\
~
`
*
_
-
+
.
!

语法说明:就不一一列举了,基本上跟js转义是一样的。

十二、空格及换行

半方大的空白&ensp;或#8194;
全方大的空白&emsp;或&#8195;
不断行的空白格&nbsp;或&#160;

注意:当不能换行时可以采用先输入空格后再跟回车进行换行。