Markdown的使用分享

一、Markdown介绍

Markdown是一种轻量级标记语言,允许人们使用易读易写的纯文本格式编写文档。Markdown的用途十分广泛,写博客、写论文、做笔记、写文档等等都可以使用Markdown,当前许多网站也都在使用Markdown,比如常见的Github、简书、reddit,包括你正在浏览的这篇CSDN博客也是使用Markdown撰写的。

二、Markdown语法

Markdown之所以能够被广泛使用,最重要的原因之一就是其语法规则简单易记。

1. 标题

Markdown的标题有以下两种格式,其中第二种方式最为常用:

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

    这是一级标题
    ==========
    这是二级标题
    ----------
    

    效果展示如下:

    这是一级标题

    这是二级标题

  2. 使用 # 标记标题级别
    一级标题对应一个#,二级标题对应两个#,以此类推
    注:最多只能标记到六级标题

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

    效果展示如下

    一级标题

    二级标题

    三级标题

    四级标题

    五级标题
    六级标题

2. 字体与强调字符

**粗体样式1**
__粗体__

*斜体样式1*
_斜体_

***加粗斜体样式1***
___加粗斜体___

~~~删除线~~~

效果展示如下:
注:符号与文字之间不能有空格,否则样式失效

粗体样式1
粗体

斜体样式1
斜体

加粗斜体样式1
加粗斜体

~删除线~

3. 段落

Markdown中的换行并不能直接通过Enter换行实现,重新开始一个段落可以通过两种换行方式实现:

  1. 在行末使用两个以上的空格再回车,表示换行
  2. 再段落后使用一个空行表示开始新的段落

4. 列表

Markdown支持有序列表和无需列表

无序列表

无序列表使用星号*,加号+或者减号-作为列表标记,标记后添加一个空格后再填写列表内容
使用Tab键可以实现列表嵌套,也就是多级列表

* 列表1
	* 列表1.1
	* 列表1.2
* 列表2
* 列表3
+ 列表4
	+ 列表4.1
	+ 列表4.2
+ 列表5
+ 列表6
- 列表7
	- 列表7.1
	- 列表7.2
- 列表8
- 列表9
	

效果展示如下:

  • 列表1
    • 列表1.1
    • 列表1.2
  • 列表2
  • 列表3
  • 列表4
    • 列表4.1
    • 列表4.2
  • 列表5
  • 列表6
  • 列表7
    • 列表7.1
    • 列表7.2
  • 列表8
  • 列表9

有序列表

有序列表能将文章层次更加明显地展示出来
使用数字加点.,作为列表标记
有序列表也可以嵌套使用

1. 列表1
    1. 列表1.1
	2. 列表1.2
2. 列表2
3. 列表3

效果展示如下:

  1. 列表1
    1. 列表1.1
    2. 列表1.2
  2. 列表2
  3. 列表3

5. 引用

Markdown中使用<加一个空格,表示区块引用
而且引用支持嵌套,一个>表示最外层引用,两个>表示第一层嵌套,三个>表示第二层嵌套,以此类推。

> 引用内容1
> 引用内容2
>> 第二层嵌套引用
>>> 第三层嵌套引用

效果展示如下:

最外层引用内容

第一层嵌套引用

第二层嵌套引用

6. 代码与代码块

Markdown对代码部分有独特的样式表示,分为行内代码和代码块

行内代码

行内代码可以在代码两侧使用反引号`来表示代码

我们可以使用`this.setstate`方法改变`state`的值

效果展示如下:

我们可以使用this.setstate方法改变state的值

代码块

对于代码块的展示有多种方法,最常用的就是使用连续的三个反引号```包裹代码块
```
var a = 1;
var b = 2;
console.log(a+b);
```
效果展示如下:

var a = 1;
var b = 2;
console.log(a+b);

指定代码语言可以增加高亮效果
```javascript
var a = 1;
var b = 2;
console.log(a+b);
```
效果展示如下:

var a = 1;
var b = 2;
console.log(a+b)

7. 链接

在markdown中插入链接有两种方式:

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

    这是一个链接[百度一下](www.baidu.com)
    这是一个链接百度一下

  2. <链接地址>
    http://www.baidu.com

8. 图片

插入图片语法类似于插入链接语法:

![替代文本](图片地址 “可选标题”)

![百度图标](https://www.baidu.com/img/flexible/logo/pc/result.png “百度一下”)
百度图标

9. 表格

  • Markdown使用|分割单元格,使用-分割表头和其他行
  • 使用:-设置内容与标题栏左对齐
  • 使用-:设置内容与标题栏右对齐
  • 使用:-:设置内容与标题栏居中对齐
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |

效果展示如下:

左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

10. 分隔线

在文章中插入分隔线可以分割文章结构
在Markdown中主要有三种写法:"***"、"- - -"、"___"

注:第二种写法中,-符号之间需要添加空格

正文1
***
正文2
- - -
正文3
___

效果展示如下:
正文1


正文2


正文3


11. 转义字符

当我们需要使用到Markdown语法中的特殊符号时,就要对这些符号进行转义操作
Markdown中使用反斜杠\对进行转义

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

效果展示如下:

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

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

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

总结

除了这些基础语法规则,Markdown其实还有更强大的功能,如复杂数学公式的编辑、UML图的展示、流程图的展示等等,这些内容希望能在下一次的学习中分享出来。

你可能感兴趣的:(Markdown的使用分享)