markdown

时间:2019-11-17
本文章向大家介绍markdown,主要包括markdown使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

一、Markdown标题

Markdown标题有两种格式

1. 使用 = 和 - 标记一级和二级标题

我展示的是一级标题  
==================  
我展示的是二级标题
------------------  

效果如下:

我展示的是一级标题

我展示的是二级标题

2. 使用 # 号标记

使用 # 号克表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

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

效果如下:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、Markdown 段落

段落的换行是使用两个以上空格加回车。
在某一行最后添加两个以上空格并回车,就会切换到下一个段落。

第一行
第二行

三、字体

*斜体文本*
_斜体文本_

**粗体文本**
__粗体文本__

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

效果如下:
斜体文本
斜体文本

粗体文本
粗体文本

粗斜体文本
粗斜体文本

四、分割线

在一行中使用三个以上星号、减号、底线来建立一个分割线

***
---
___

效果如下:
***
---
___

五、删除线

在文字两端加上两个波浪线 ~~ 即可

星期六
星期天
~~星期一~~

效果如下:
星期六
星期天
星期一

六、下划线

下划线通过html标签 <u> 来实现

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

效果如下:
带下划线文字

七、脚注

脚注是对文本的补充说明

来学习一下如何创建[脚注]
[^脚注]:脚注是对文本的补充说明

效果如下:
来学习一下如何创建[脚注]
[^脚注]:脚注是对文本的补充说明

八、列表

1. 无序列表使用星号 * 、加号 + 、减号 - 作为标记

* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项

- 第一项
- 第二项
- 第三项

效果如下:

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

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

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

2. 有序列表使用数字加上 . 号表示

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

效果如下:

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

3. 列表嵌套

列表嵌套只需在子列表中的选项添加四个空格即可:

1. 第一项:
    - 第一项嵌套的第一个元素
    - 第一项嵌套的第二个元素
2. 第二项
    - 第二项嵌套的第一个元素
    - 第二项嵌套的第二个元素

效果如下:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第二个元素

九、Markdown区块

markdown区块引用是在段落开头使用 > 符号,然后后面紧跟一个空格符号:

> 区块引用  
> markdown区块引用  
> 学习markdown区块引用

效果如下:

区块引用
markdown区块引用
学习markdown区块引用

区块是可以嵌套的,一个 > 符号是最外层,两个 > 是第一层嵌套,以此类推

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

效果如下:

最外层

第一层嵌套

第二层嵌套

十、Markdown代码

如果是段落上的一个函数或片段的代码可以用反引号 ` 把它括起来。

`printf()`函数

效果如下:
printf()函数

代码区块

代码区块使用 ``` 包裹一段代码,并指定一种语言(也可以不指定)
```javascript
$(document).ready(function){
    alert('代码区块');
});
```
效果如下:

$(document).ready(function){  
    alert('代码区块');  
});

十一、Markdown链接

[链接名称](链接地址)

或者

<链接地址>

例如:

[博客园](http://www.cnblogs.com)

效果如下:
博客园

直接使用链接地址:

<http://www.cnblogs.com>

效果如下:
http://www.cnblogs.com

高级链接

链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 博客园 作为网址变量 [博客园][博客园]
然后在文档的结尾为变量赋值(网址)


[1]:http://www.google.com
[博客园]:http:www.cnblogs.com

效果如下:
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 Google
这个链接用 博客园 作为网址变量 博客园
然后在文档的结尾为变量赋值(网址)

十二、Markdown图片

格式如下:

![alt属性文本](图片地址)
![alt属性文本](图片地址 "可选标题")
  • 开头一个感叹号!
  • 接着一个方括号,里面放上图片的替代文字
  • 接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上选择性的‘title’属性的文字
![博客园图标](https://www.cnblogs.com/images/logo_small.gif)
![博客园图标](https://www.cnblogs.com/images/logo_small.gif "博客园")

效果如下:

markdown没有办法指定图片的高度与宽度,如果需要,可以使用标签

<img src="https://www.cnblogs.com/images/logo_small.gif" width="50%"/>

效果如下:

十三、Markdown表格

markdown制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

|  表头  |  表头  |
| ----   | ----  |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

效果如下:
| 表头 | 表头 |
| ---- | ---- |
| 单元格 | 单元格 |
| 单元格 | 单元格 |

对齐方式

  • -: 内容和标题栏右对齐
  • :- 内容和标题栏左对齐
  • :-: 内容和标题栏居中对齐
| 左    | 右    | 居中   |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果如下:
| 左 | 右 | 居中 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

十四、Markdown高级技巧

不在markdown涵盖范围之内的标签,都可以直接在文档里面用html撰写。
目前支持的Html元素有:<kbd> <b> <i> <sup> <sub> <br>

  1. <kbd>标签定义键盘文本。
    用来表示文本是从键盘上键入的。浏览器通常用等宽字体来显示该标签中包含的文本。
    键入<kbd>quit</kbd>来退出程序
    键入quit来退出程序

  2. <b>标签规定粗体文本
    <b>这是粗体文本</b>
    这是粗体文本

  3. <i>标签显示斜体文本效果
    <i>斜体文本</i>
    斜体文本

  4. <sup>标签可定义上标文本
    包含在<sup>标签和其结束标签</sup>中的内容将会以当前文本流中字符高度的一半来显示,但是与当前文本流中文字的字体和字号都是一样的。这个标签在向文档添加脚注以及表示方程式中的指数值时非常有用。
    这段文本包含<sup>上标</sup>
    这段文本包含上标

  5. <sub>标签可定义下标文本
    包含在<sub>标签和其结束标签</sub>中的内容将会以当前文本流中字符高度的一半来显示,但是与当前文本流中文字的字体和字号都是一样的。
    该段文本包含<sub>下标</sub>
    该段文本包含下标

  6. <br>标签可插入一个简单的换行符

十五、转义

Markdown使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown使用反斜杠转义特殊字符

**文本加粗**
\*\*正常显示星号\*\*

效果如下:
文本加粗
**正常显示星号**

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

\  反斜线
`  反引号
*  星号
_  下划线
{} 花括号
[] 方括号
() 小括号
#  井字号
+  加号
-  减号
.  英文句点
!  感叹号








参考资料:Markdown教程

原文地址:https://www.cnblogs.com/fanful/p/11877548.html