Markdown 教程

一、Markdown 简介

Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。你可以用纯文本编写带格式的文档，后缀通常是 .md。

优点：易读易写、跨平台、可轻松转为 HTML / PDF。

---

二、基础语法

标题

在行首加 #，数量决定级别：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题

文字样式

**加粗**
*斜体*
~~删除线~~
`行内代码`

效果：加粗、斜体、删除线、行内代码

列表

无序列表用 -、* 或 +：

- 项目一
- 项目二
  - 嵌套项目

有序列表用数字 + 点：

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

链接 & 图片

[链接文字](https://example.com)
![图片描述](https://example.com/image.png)

引用

> 这是一段引用文字
> 可以跨多行

效果：

这是一段引用文字

分割线

三个或以上 -、*、_：

---

---

三、代码块

三个反引号包裹，指定语言可开启语法高亮：

function hello() {
  console.log('Hello, Markdown!')
}

表格

| 姓名 | 年龄 | 职业 |
|------|------|------|
| 小明 | 20   | 学生 |
| 小红 | 22   | 设计师 |

对齐方式：

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容   | 内容 | 内容   |

---

四、进阶技巧

任务列表

- [x] 已完成任务
- [ ] 待办任务
- [ ] 另一项待办

脚注

这是一段带脚注的文字[^1]。

[^1]: 这是脚注内容。

转义字符

用反斜杠 \ 转义特殊符号：

\* 不会被解析为斜体 \*
\# 不会被解析为标题

---

五、常用工具

工具	用途
Typora	所见即所得编辑器
VS Code + 插件	边写代码边写文档
Obsidian	笔记管理
marked / markdown-it	JS 渲染库