markdown入门教程

发表于

一、Markdown 是什么？

Markdown 是一种轻量级标记语言，核心思想：

👉 用“接近自然语言”的方式写文档 → 自动转换为 HTML / PDF / 网页

常用于:

  • 技术文档（GitHub）
  • 博客（静态站点）
  • README
  • 笔记（Obsidian / Typora）

二、入门级（必须掌握）

1. 标题

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

效果：

一级标题

二级标题

三级标题

2. 段落 & 换行

1
2
3
这是第一段

这是第二段

👉 空一行 = 新段落

3. 强调

1
2
3
*斜体*
**加粗**
***加粗斜体***

效果：

斜体
加粗
加粗斜体

4. 列表

无序列表

1
2
3
- 苹果
- 香蕉
- 橘子

有序列表

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

5. 链接

1
[Google](https://www.google.com)

6. 图片

1
![描述](图片URL)

7. 代码

行内代码

1
使用 `python` 编程

代码块

1
2
3
```python
print("Hello World")
```

8. 引用

1
> 这是引用

效果：

这是引用

9. 分割线

1
---

三、进阶用法

1. 表格

1
2
3
4
| 名字 | 年龄 | 城市 |
|------|------|------|
| 张三 | 18   | 北京 |
| 李四 | 20   | 上海 |

👉 表格使用 | 分割列，- 分割表头和内容，: 表示对齐方式

效果：

名字 年龄 城市
张三 18 北京
李四 20 上海

2. 任务列表（TODO）

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

👉 任务列表使用 - [ ] 开头，[x] 表示已完成，[ ] 表示未完成

效果：

  • 已完成
  • 未完成

3. HTML 混写（关键能力）

Markdown 支持 HTML：

1
<div style="color:red">红色文字</div>

👉 用于：

  • 自定义样式
  • 布局控制

效果：
红色文字

4. 锚点跳转

1
[跳到二级标题](#二级标题)

跳到二级标题

5. 表情符号

😊🎉🎁✔💃👌

👉 详情参考：表情符号

四、高级玩法

1. 数学公式（LaTeX）

很多编辑器支持：

1
2
3
4
5
6
行内公式：$E = mc^2$

块级公式：
$$
\int_a^b f(x) dx
$$

👉 行内公式使用 $ 包裹，块级公式使用 $$ 包裹

效果：

行内公式：$E = mc^2$

块级公式：
$$
\int_a^b f(x) dx
$$

2. Mermaid 图

1
2
3
4
```mermaid
graph TD
A --> B
B --> C

👉 可画：

  • 流程图
  • 架构图
  • 时序图

Mermaid

3. 代码高亮 + 行号

1
2
3
```python {linenos}
def hello():
    print("hi")

👉 使用 {linenos} 添加行号

1
2
def hello():
    print("hi")

4. 脚注

这是一个说明[^1]

[^1]: 这里是脚注

👉 脚注使用 [^编号] 添加，[编号]: 脚注内容 定义