Markdown 语法教程

发表于
分类：教程 · 标签：教程

本文字数：2219  阅读时长：5分钟

访客数：加载中... | 阅读量：加载中...

AI摘要

Markdown语法

初了上面这些，当你在书写文章的时候，还会遇到一个问题，就是怎么排版，这不像你的word，直接点点点，这里有一个专门的语法，叫markdown语法，熟悉之后其实很简单，非常方便，也有很多专门书写markdown文章的编辑器，例如obsidian，这也是雪一直使用的编辑器，这里附上下载地址

点我跳转obsidian下载地址

下面会简单介绍一下用的最多的语法，本部分使用AI生成

一、Markdown 是什么？

Markdown 是一种非常简单的文字排版语言 你不需要像 Word 一样点击各种按钮，只需要使用一些简单的符号，就可以让文字变成：

  • 标题
  • 粗体
  • 斜体
  • 删除线
  • 图片
  • 链接
  • 表格
  • 代码
  • 引用
  • 列表

例如：

markdown
# 这是一个标题

这是一段普通文字

**这是粗体**

*这是斜体*

显示出来就是：

这是一个标题

这是一段普通文字 这是粗体 这是斜体

二、标题

Markdown 使用 # 来表示标题，# 越多，标题等级越低

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

显示效果：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

一般写文章的时候，使用：

markdown
# 文章标题
## 第一章
### 第一节
### 第二节
## 第二章

就已经足够了

三、普通文字

直接输入文字即可

markdown
这是一段普通文字。
这是第二段文字。

显示： 这是一段普通文字。 这是第二段文字。 如果想换一段，需要空一行

四、换行

Markdown 中直接按一次 Enter，有些编辑器不会真正换行 例如：

markdown
第一行
第二行

有些 Markdown 编辑器可能会把它显示成：

第一行 第二行

如果希望明确换行，可以在第一行最后加两个空格：

markdown
第一行  
第二行

也可以使用 <br>：

markdown
第一行<br>
第二行
五、粗体

在文字两边加两个 *：

markdown
**这是粗体**

显示： 这是粗体 也可以使用两个 _：

markdown
__这是粗体__
六、斜体

在文字两边加一个 *：

markdown
*这是斜体*

显示： 这是斜体 也可以：

markdown
_这是斜体_
七、粗体 + 斜体

三个 *：

markdown
***这是粗体斜体***

显示： 这是粗体斜体

八、删除线

使用两个 ~：

markdown
~~这句话不要了~~

显示： 这句话不要了 例如：

markdown
原价：~~99 元~~
现在只要 59 元！
九、链接

链接的基本格式：

markdown
[显示的文字](网址)

例如：

markdown
[访问 GitHub](https://github.com)

显示： 访问 GitHub

再举一个例子
markdown
这是我的[个人博客](https://example.com)。

显示： 这是我的个人博客。

十、图片

图片的格式和链接非常像，只需要在前面加一个 !：

markdown
![图片描述](图片地址)

例如：

markdown
![一张图片](https://example.com/image.jpg)

其中：

  • !：告诉 Markdown 这是图片
  • 图片描述：图片无法显示时显示的文字
  • 图片地址：图片的 URL
本地图片

如果图片和 Markdown 文件在同一个文件夹：

text
文章.md
图片.jpg

可以写：

markdown
![我的图片](图片.jpg)

如果图片放在 images 文件夹：

text
文章.md
images/
  └── photo.jpg

写：

markdown
![我的图片](images/photo.jpg)
十一、引用

使用 >：

markdown
> 这是一段引用。

显示：

这是一段引用。

也可以引用多行：

markdown
> 这是第一行。
> 这是第二行。
> 这是第三行。

显示：

这是第一行。
这是第二行。
这是第三行。

引用非常适合：

  • 引用别人说的话
  • 写提示
  • 写文章摘要
  • 添加注意事项

例如：

markdown
> 注意：删除文件之前请先备份。
十二、无序列表

使用 -、* 或 + 都可以。 最常用的是 -：

markdown
- 苹果
- 香蕉
- 西瓜
- 草莓

显示：

  • 苹果
  • 香蕉
  • 西瓜
  • 草莓
十三、有序列表

使用数字：

markdown
1. 第一步
2. 第二步
3. 第三步

显示：

  1. 第一步
  2. 第二步
  3. 第三步
不需要自己写正确的数字

实际上全部写 1. 也可以：

markdown
1. 第一步
2. 第二步
3. 第三步

Markdown 编辑器通常会自动显示为：

  1. 第一步
  2. 第二步
  3. 第三步
十四、嵌套列表

列表里面还可以继续套列表。

markdown
- 水果
  - 苹果
  - 香蕉
  - 西瓜

- 饮料
  - 可乐
  - 咖啡
  - 茶

显示：

  • 水果
    • 苹果
    • 香蕉
    • 西瓜
  • 饮料
    • 可乐
    • 咖啡
    • 茶

注意：子列表前面通常需要缩进两个或四个空格。

十五、任务列表 / 待办事项

使用：

markdown
- [ ] 没有完成
- [x] 已经完成

显示：

  • 没有完成
  • 已经完成

例如：

markdown
## 今日任务

- [x] 写 Markdown 教程
- [x] 发布文章
- [ ] 整理代码
- [ ] 更新博客
十六、代码

如果只需要在一句话中写一小段代码，可以使用一个反引号：

markdown
使用 `git pull` 更新代码

显示： 使用 git pull 更新代码 这里的：

text
`

叫做反引号，一般在键盘左上角，数字 1 的左边

十七、代码块

如果需要放一大段代码，可以使用三个反引号：

markdown
```javascript
console.log("Hello World");
```

显示：

javascript
console.log("Hello World");
十八、指定代码语言

三个反引号后面可以写代码语言 例如 JavaScript：

markdown
```javascript
const name = "雪";

console.log(name);
```

Python：

markdown
```python
name = "雪"

print(name)
```

HTML：

markdown
```html
<h1>Hello World</h1>
```

CSS：

markdown
```css
body {
  margin: 0;
}
```

常见语言：

text
javascript
typescript
python
java
c
cpp
html
css
json
bash
powershell
sql
十九、分割线

使用三个 -：

markdown
---

显示：

也可以：

二十、表格

Markdown 可以非常简单地制作表格 基本格式：

markdown
| 姓名 | 年龄 | 城市 |
| --- | --- | --- |
| 小明 | 18 | 北京 |
| 小红 | 20 | 上海 |
| 小刚 | 19 | 广州 |

显示：

姓名年龄城市
小明18北京
小红20上海
小刚19广州

表格对齐

左对齐：

markdown
| 姓名 |
| :--- |
| 小明 |

居中：

markdown
| 姓名 |
| :---: |
| 小明 |

右对齐：

markdown
| 姓名 |
| ---: |
| 小明 |
二十一、转义特殊符号

Markdown 中有一些符号具有特殊作用 例如：

markdown
# 标题

会变成标题 如果你就是想显示 # 标题，可以在前面加反斜杠：

markdown
\# 标题

显示： # 标题

text
常见需要转义的符号：

```text
\*
\#
\-
\_
\`

简单理解：

在特殊符号前加 \，就可以让它失去 Markdown 的特殊功能。

二十二、HTML

Markdown 里面也可以使用部分 HTML 例如：

html
<b>这是粗体</b>

显示： 这是粗体 换行：

html
第一行<br>
第二行

不过对于 Markdown 小白来说，大多数情况下不需要使用 HTML 好啦，这些就够日常使用啦，其实也根本用不了这么多，但是可以了解一下，万一哪天想用一下呢！