Markdown学习

简介

Markdown是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档，Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档，当前许多网站都广泛使用 Markdown 来撰写帮助文档或是用于论坛上发表消息。

Markdown有什么好处，一个是可以语法非常简单，很好学，二是不用花很多时间在排版上，第三个生成文件非常小，可以多平台发布，比如hexo之类的博客文章就是通过Markdown来写的，WordPress虽然用的是古腾堡编辑器，但也是专门的Markdown插件，写好以后复制粘贴即可发布。

常用编辑器：VSCode编辑器，Typora

（注：VSCode肯定是免费的，Typora现在已经要花钱了，可以在网上下免费老版本用）

Markdown基本语法

标题

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

输入标题文字，shift + enter 另起一行， 输入两个或两个以上 “ = / - ” 。

1
2
3
4
5
我展示的是一级标题
=================

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

2、使用#号标记

使用 **#**号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推

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

段落和字体

Markdown 段落没有特殊的格式，直接编写文字就好，段落的换行是使用两个以上空格加上回车。

字体

1
2
3
4
5
6
*某人是大帅哥*
_某人是大帅哥_
**某人是大帅哥**
__某人是大帅哥__
***某人是大帅哥***
___某人是大帅哥___

如果段落上的文字要添加删除线，只需要在文字的两端加上两个波浪线 ~~ 即可

1
~~某人是大帅哥~~

下划线可以通过 HTML 的<u>标签来实现

某人是大帅哥

列表

Markdown 支持有序列表和无序列表。无序列表使用星号(****)、加号(+)或是减号(*-**)作为列表标记，这些标记后面要添加一个空格。

1
2
3
* 某人是大帅哥
+ 某人是大帅哥
- 某人是大帅哥
  • 某人是大帅哥
  • 某人是大帅哥
  • 某人是大帅哥

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

1
2
1. 某人真是帅
2. 某人是大帅哥
  1. 某人真是帅
  2. 某人是大帅哥

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

1
2
3
1. 某人为什么是大帅哥
    - 因为某人五官端正
    - 因为某人身材好
  1. 某人为什么是大帅哥
    • 因为某人五官端正
    • 因为某人身材好

引用

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

1
> 区块引用

区块引用

区块是可以嵌套的，一个 > 符号是最外层，两个 > 符号是第一层嵌套

1
2
3
> 最外层
> > 第一层嵌套
> > >第二层嵌套

最外层

第一层嵌套

第二层嵌套

区块中使用列表

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

区块中使用列表

  1. 第一项
  2. 第二项

列表中使用区块

如果要在列表项目内放进区块，那么就需要在 > 前添加四个空格的缩进

1
2
3
4
* 第一项
    > 某人帅
    > 某人好帅
* 第二项
  • 第一项

    某人帅
    某人好帅

  • 第二项

代码

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

1
`function()`函数

function()函数

可以用 ``` 包裹一段代码，并指定一种语言（也可以不指定)

1
2
3
4
#include<stdio.h>
int main(void) {
    printf("Hello,World!");
}

链接

链接使用方法：

1
[链接名称](链接地址)或者<链接地址>

某人的魔法空间

https://huihuige.xyz

链接标记可以有字母、数字、空格和标点符号;链接标记不区分大小写;定义的链接内容可以放在当前文件的任意位置;当链接地址为网络地址时要以http/https开头，否则会被识别为本地地址。

图片

图片语法格式：

1
![alt 属性文本](图片地址)

类似于HTML中图像标签，里面alt是图片不能显示时替代文本，也可以加上双引号包括文字得到鼠标悬停显示内容，类似图片标签title属性

1
[![新垣结衣](https://img.huihuige.xyz/images/2022/02/12/3f791fca358861674eaf3623aa0c56df.gif "新垣结衣")

新垣结衣

如果不能正常显示

新垣结衣

表格

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

语法格式：

1
2
3
4
|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |
表头 表头
单元格 单元格
单元格 单元格

对齐方式：

  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐
1
2
3
4
| 左对齐 | 右对齐 | 居中对齐 |
| :-----| ----: | :----: |
| 单元格 | 单元格 | 单元格 |
| 单元格 | 单元格 | 单元格 |
左对齐 右对齐 居中对齐
单元格 单元格 单元格
单元格 单元格 单元格

Markdown扩展语法

转义

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

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
Markdown支持以下这些符号前面加上反斜杠来帮助插入普通的符号
\   反斜线
`   反引号
*   星号
_   下划线
{}  花括号
[]  方括号
()  小括号
#   井字号
+   加号
-   减号
.   英文句点
!   感叹号

表情符号

包裹表情代码：

1
2
3
:smile:
:+1:
:-1:

:smile: ​ :+1: :-1:（可能用不了）

任务列表

任务列表的语法：

1
2
- [ ] 未勾选
- [x] 已勾选
  • 未勾选
  • 已勾选
    任务列表以-+空格开头，由 [+空格/x+] 组成,x可以小写，也可以大写，有些编辑器可能不支持大写，所以为避免解析错误，推荐使用小写的x,当方括号中的字符为空格时，复选框是未选中状态，为x时是选中状态。

锚点

锚点，也称为书签，用来标记文档的特定位置，使用锚点可以跳转到当前文档或其他文档中指定的标记位置

类似于HTML里的锚点定位，通过创建锚点链接，用户能够快速定位到目标内容。

锚点语法格式：

1
[锚点描述](#锚点名称)

简介