markdown常用语法

Posted on 2023-03-22 Edited on 2023-04-11 In markdown

这篇文章整理了markdown(.md)文件几乎所有常用的写法。

标题

创建标题，使用“# ”。在文字前方加一个井号、一个空格，就可以创建一级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题

强调

加粗

在要加粗部分的两侧，各添加两个星号。
输入：
这是要**加粗**的文本
效果为：
这是要加粗的文本

斜体

在斜体的文本前后，各添加一个星号。
输入：
这是要*斜体*的文本
效果为：
这是要斜体的文本

加粗+斜体

同时用粗体和斜体突出显示文本，在文本的前后，各添加三个星号。
输入：
这是要***加粗+斜体***的文本
效果为：
这是要加粗+斜体的文本

删除线

要删除单词，在单词前后使用两个波浪号~~。
输入：
ABCDEFG~~DEFG~~HIJK
效果为：
ABCDEFG~~DEFG~~HIJK

引用

要创建块引用，在需要引用的段落前添加一个 > 符号。如果引用包含多个段落，其前方都需要加>。
输入：
>这是被引用的文本
>这是被引用的文本

效果为：

这是被引用的文本
这是被引用的文本

列表

带序号列表

创建带序号列表，可以在每个列表项前，添加数字并紧跟一个英文句点，再加一个空格。
1. 第一项
2. 第二项
效果为：

第一项
第二项

无序号列表

创建无序号列表，可以在每个列表项前，添加减号(-)或星号(*)或加号(+)，再加一个空格。
输入：
- 第一项
- 第二项
效果为：

第一项
第二项

如果需要，可以嵌套列表。
输入：
- 第一项
(tab)- 第一项的第1条
(tab)- 第一项的第2条
- 第二项
效果为：

第一项
- 第一项的第1条
- 第一项的第2条
第二项

如果自动缩进的格式不对，可以使用tab或者shift+tab调整缩进距离，再用- 文本添加列表项。
列表中不仅可以嵌套列表，还可以嵌套引用、代码块、图片，可以自己尝试。

代码

短代码

要将单词或短语表示为代码，将其前后加上反引号 (`) ，就是键盘1左侧的键，注意调成英文键盘。
输入：
`code`
效果为：
code

代码块

要创建代码块，将其前方加上3个连续的反引号(```)，并键入这段代码的语言。
也可以暂不键入语言，在3个连续的反引号后直接回车，则代码不会有高亮，仅是文本。
输入：
```java
String phone = user.getPhone();

效果为：

1	String phone = user.getPhone();

分隔线

创建分隔线，可以在单独一行上，使用三个或多个星号 (***)、破折号 (---) ，并回车。
输入：
---
效果为：

表格

添加表格，可以用三个连字符(---)创建列标题，并使用管道（|）分隔每列。表格最左最右也可以添加管道。
输入：
| | | | | |
|---|---|---|---|---|
| | | | | |
| | | | | |
| | | | | |
效果为：

也可以使用https://www.tablesgenerator.com/markdown_tables 页面生成表格，复制到你的markdown文件中。

链接

超链接文本放在中括号内，超链接地址放在后面的括号中，链接title可选。
语法为：[超链接在页面上显示的名字](地址)
输入：
这是一个链接 [kexin的主页](https://github.com/kathy-kx/kathy-kx.github.io)
效果为：
这是一个链接 kexin的主页

注：点击链接时，有可能需要按下“command+点击”(macOS系统)，才能打开链接。

链接的title（可选）

如果加上链接title，在鼠标悬停在链接上时可以出现文字。
语法为：[超链接在页面上显示的名字](链接的地址 "title")
输入：
这是一个链接 [kexin的主页](https://github.com/kathy-kx/kathy-kx.github.io "kexin的github主页")
效果为：
这是一个链接 kexin的主页

将网址变为链接的简便方法

不同于上面完整的语法，可以简单的在链接左右加上尖括号<>，就能把地址转换为可点击的链接。
输入：<https://github.com/kathy-kx/kathy-kx.github.io>
效果为：https://github.com/kathy-kx/kathy-kx.github.io

禁用自动URL链接

有些Markdown处理器会自动将URL转换为链接。这意味着如果您输入网址http://www.example.com ，Markdown处理器会自动将其转换为链接。如果不希望自动转为链接URL，或者移除链接只显示文本，在链接左右加上反引号(`)
效果为：https://github.com/kathy-kx/kathy-kx.github.io

图片

图片为网络链接

添加图片，可以使用感叹号(!)，在方括号内写替代文本，在圆括号内写链接，链接后可以在双引号内增加图片title（可选）。
语法为：![图片](图片链接地址 "图片title")
输入：
![图片](https://hbimg.huaban.com/ad79b34e31c08a0e74ee27f61635c677aedb05f2516dc-HXpp2K_fw658 "甘雨")
效果为：

图片在本地

在hexo文件夹下的source目录下，新建一个文件夹叫images(名字随意)，将要插入的图片放在该文件夹中。
圆括号内的链接写(/images/name.jpeg)。这里的 / 指的是根目录，对于hexo，资源文件的根目录就是source。
输入：
![图片](/images/20.jpeg "甘雨")
效果为：

（图源网络，侵删）
如果图片无法显示，可以尝试修改hexo文件夹中的_config.yml文件，如下：

post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

任务列表(复选框)

创建任务列表（也可以作为复选框），可以依次在任务列表项之前，添加破折号-、空格、方括号[ ]和空格，注意[ ]内也有一个空格。即，-空格[空格]空格列表项。
若要选中一个复选框，在方括号[x]之间添加 x，替换原本方括号内的空格。即，-空格[x]空格列表项。
输入：
- [ ] 算法题
- [ ] 项目推进
- [x] 运动

效果为：

算法题
项目推进
运动