Markdown 语法学习笔记

记录一下一些markdown基本的语法

1. 标题#

1
# 一级标题
2
## 二级标题
3
### 三级标题
4
#### 四级标题

2. 段落与换行#

段落：直接空一行就是新段落
换行：多数 Markdown 里「行尾两个空格 + 回车」可强制换行

1
第一段。
2

3
第二段（与上一段中间空一行）。
4

5
这一行末尾加两个空格
6
就会换行（取决于渲染器设置）。

3. 强调：粗体/斜体/删除线#

1
*斜体* 或 _斜体_
2
**粗体** 或 __粗体__
3
***粗斜体***
4
~~删除线~~

4. 引用#

1
> 这是一段引用
2
>
3
> 引用也可以分段
4
>> 也支持嵌套引用

5. 列表#

5.1 无序列表#

1
- 项目一
2
- 项目二
3
  - 子项目（缩进 2~4 个空格）

5.2 有序列表#

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

5.3 任务列表#

1
- [ ] 未完成
2
- [x] 已完成

6. 代码：行内代码与代码块#

6.1 行内代码#

1
使用 `pnpm dev` 启动开发服务器。

6.2 代码块#

常见语言：js ts bash json html css md python

1
```js
2
function sum(a, b) {
3
  return a + b;
4
}
5
```

7. 链接#

1
[文字链接](https://example.com)
2
[带标题的链接](https://example.com "提示文本")

7.1 引用式链接#

1
这是一个链接：[我的站点][site]
2

3
[site]: https://example.com

8. 图片#

1
![图片说明](https://example.com/image.png)

本地图片是否可用取决于博客框架/构建配置（有的需要放到指定目录）。

9. 分割线#

1
---

10. 表格#

1
| 列1 | 列2 | 列3 |
2
| --- | --- | --- |
3
| a   | b   | c   |
4
| 1   | 2   | 3   |

对齐：

1
| 左对齐 | 居中 | 右对齐 |
2
| :----- | :--: | -----: |
3
| a      | b    | c      |

11. 转义#

当你想显示 Markdown 符号本身时，用反斜杠：

1
\* 这不是斜体 \*
2
\# 这不是标题

12. html#

很多渲染器允许混用少量 HTML：

1
<p>这是一段 HTML 段落</p>
2
<br />

是否支持取决于站点的 Markdown 渲染配置（有的会禁用部分 HTML）。

13. 最小写作模板#

1
---
2
title: 文章标题
3
published: xxxx-xx-xx
4
description: 一句话介绍文章内容
5
tags: [tag1, tag2]
6
category: notes
7
draft: false
8
---
9

10
> 小引用写明写作目的
11

12
## 小节标题 1
13
正文...
14

15
## 小节标题 2
16
- 要点 1
17
- 要点 2
18

19
```bash
20
# 示例命令
21
echo "hello,world"
22
rm -rf /* (bushi)
23
```