一、markdown简介

(注:如果对markdown有一定了解。可以略过此处,第一章主要对markdown基础知识做个补充,摘自菜鸟教程此处原文档

1.1 markdown背景

1. markdown是一种轻量级标记语言,她与徐人们使用易读易写的纯文本格式编写文档。

2. Markdown 语言在 2004 由约翰·格鲁伯(英语:John Gruber)创建。

3. Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。

4. Markdown 编写的文档后缀为 .md, .markdown。

1.2 markdown应用

Markdown 能被使用来撰写电子书,如:Gitbook。

当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。例如:GitHub、简书、reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge等。

1.3 编辑器

编辑器有很多种,基本各大编辑器都可以编辑markdown格式文档。

比如:Typora,sublime Text, coderunner,印象笔记,vim等等等。具体的可以百度,都非常好用。


二、markdown基本操作

1.标题

使用#号标记,可以表示1-6级标题,随#个数递增。如:

1
2
3
4
5
6
7
8

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

注:最后一个#与文字间一定要有一个空格。

显示效果:

显示效果

2.换行

markdown换行方式有很多种

  • 直接在一句话后面敲两个空格
  • 两句话之间加一个空行
  • 如果你在编辑的时候,想让一行文字分成几段在显示的时候换行,就在中间加

image.png

此点是我想在表格里换行时get到的,也很实用,后面讲到表格我会展示。

3.字体

markdown支持几种字体:

1
2
3
4
5
6
7
8

*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___

把你想修改的字段直接放在中间即可。显示效果如下:

image.png

4.分割线

markdown中分割线,能是你的文章结构更加清楚

几种分割线的写法:

1
2
3
4
5
6
7
8
9
10
11

***

* * *

*****

- - -

----------

这些都可以是分割线。如果你在你自己的博客网站加上美化,他可以看着更舒服哈哈哈。

5.删除线,下划线。

写法如下:

1
2
3
4
5

~~删除线~~

<u>下划线</u>

显示效果:

image.png

6.分点条列

  1. 无序

markdown可以通过 * - + 开头作为列表标记。

1
2
3
4
5
6
7
8
9
10

* 第一行
* 第二行

- 第一行
- 第二行

+ 第一行
+ 第二行

显示效果:

image.png

  1. 有序

有序的直接数字后面跟着一个点就可以了,和咱们平时写的一样。

  1. 嵌套使用

有序无序也可以嵌套使用 如:

1
2
3
4
5

1.第一行
- 第一点
- 第二点

效果:

image.png

7.区块

markdown区块是在段落开头使用 “>”,依然是紧跟空格

写法如下:

1
2
3
4
5

> markdown
> 基础
> 区块引用

效果:

markdown
基础
区块引用

  1. 区块嵌套

通过”>” 个数展示分层差别:

1
2
3
4
5

> markdown
>> 基础
>>> 区块引用

效果:

markdown

基础

区块引用

  1. 区块中使用列表

实例如下:

1
2
3
4
5
6
7
8

> 区块中使用列表
> 1. 第一项
> 2. 第二项
>> + 第一项
>> + 第二项
>> + 第三项

效果:

区块中使用列表

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

注:在列表中使用区块是同样的道理,这里不再赘述。


三、markdown进阶

1. markdown 插入代码

  • 插入一行代码
1
2
`int a = 0;`//英文版的数字1左边的那个符号。。。。

效果:

int a = 0;

  • 插入代码块
1
2
3
4
5
6
7

​```紧跟着可以写上用的什么语言,也可以不用写。
int a = 1;
int b = 2;

​```结尾与开头一样

效果:

1
2
3
4

int a = 1;
int b = 2;

2.markdown插入链接

链接语法如下:

1
2
3
4
5
6
7
8
[链接名称](链接地址)

或者


<链接地址>


注意:符号全英文

比如:

[这是百度](https://www.baidu.com)

效果:

这是百度

记着点完返回阿,或者新建页面打开,嘿嘿嘿

3.markdown插入图片

1
2
3
4
5
6
7
![图片描述,可写可不写,但是中括号要有](图片地址,本地链接或者URL地址。)


比如我此文章的图片:

![markdown](https://ss2.bdstatic.com/70cFvnSh_Q1YnxGkpoWK1HF6hhy/it/u=1613194509,3683268681&fm=26&gp=0.jpg)

最后会显示出来,我就不做效果拉。

4. markdown表格

每排单元格要用 | 分开 表头与内容用 —- 分开

语法如下

1
2
3
4
5
6

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

表头 表头 表头 表头
单元格 单元格 单元格 单元格
单元格 单元格 单元格 单元格

:可以实现左对齐,右对齐,居中。不加则默认为左对齐

5.markdown支持HTML元素

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有:
等 ,如:

1
2
3

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

image.png