一、什么是Markdown？
Markdown是一种轻量级标记语言，通过简单的语法实现文档的格式化。它易读易写，是写文档、笔记、博客的首选。
1.1 Markdown特点
1
2
3
4
5
6
7
8
9
10
11
| ┌─────────────────────────────────────────────────────────────────┐
│ Markdown特点 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 📝 简单 → 几分钟就能上手 │
│ 👀 易读 → 纯文本也能正常阅读 │
│ 🔄 通用 → 几乎所有平台都支持 │
│ 🎨 灵活 → 支持HTML嵌入 │
│ 📤 导出 → 可转换为PDF、Word、HTML等 │
│ │
└─────────────────────────────────────────────────────────────────┘
|
1.2 应用场景
| 场景 |
说明 |
| 写博客 |
Hexo、Hugo等静态博客 |
| 文档 |
GitHub README、项目文档 |
| 笔记 |
Notion、Obsidian |
| 写书 |
技术书籍、教程 |
| 论文 |
支持LaTeX公式 |
二、基础语法
2.1 标题
1
2
3
4
5
6
| # 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
|
效果：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
💡 技巧：# 和文字之间要加空格
2.2 段落与换行
1
2
3
4
5
6
| 这是第一段
这是第二段（空一行）
这是第三段
这是同一段落（行尾加两个空格）
|
效果：
这是第一段
这是第二段（空一行）
这是第三段
这是同一段落（行尾加两个空格）
2.3 字体
1
2
3
4
5
6
7
8
| *斜体*
_斜体_
**粗体**
__粗体__
***粗体+斜体***
___粗体+斜体___
~~删除线~~
<u>下划线</u>
|
效果：
斜体
斜体
粗体
粗体
粗体+斜体
粗体+斜体
删除线
下划线
2.4 分隔线
效果：
三、列表
3.1 无序列表
1
2
3
4
5
6
7
8
9
| - 项目1
- 项目2
- 子项目2.1
- 子项目2.2
- 项目3
* 项目1
* 项目2
+ 项目3
|
效果：
3.2 有序列表
1
2
3
4
5
6
7
8
| 1. 第一步
2. 第二步
3. 第三步
1. 第一步
1. 子步骤1
2. 子步骤2
2. 第二步
|
效果：
第一步
第二步
第三步
第一步
- 子步骤1
- 子步骤2
第二步
3.3 任务列表
1
2
3
| - [ ] 待办事项1
- [x] 已完成事项2
- [ ] 待办事项3
|
效果：
四、链接与图片
4.1 超链接
1
2
3
4
5
6
7
8
| [链接文字](URL)
[点击访问百度](https://www.baidu.com)
[链接文字][引用名称]
[引用名称]: URL "标题"
<https://www.baidu.com>
<email@example.com>
|
效果：
点击访问百度
https://www.baidu.com
email@example.com
4.2 图片
1
2
3
4
5
6
7
8
9
10
| 
<!-- 指定尺寸 -->
<img src="url" width="200" height="100">
<!-- 居中显示 -->
<p align="center">
<img src="url" width="200"/>
</p>
|
效果：
4.3 图片引用
1
2
3
| ![logo][logo]
[logo]: https://example.com/logo.png "Logo标题"
|
五、代码
5.1 行内代码
1
2
3
4
5
| 这是 `行内代码`，用于包裹代码片段。
使用 `console.log()` 打印输出。
键盘按键 `<Ctrl>+<C>`
|
效果：
这是 行内代码，用于包裹代码片段。
使用 console.log() 打印输出。
5.2 代码块
```语言
代码内容
1
2
3
4
5
6
7
8
9
|
```python
# Python示例
def hello():
print("Hello, World!")
class User:
def __init__(self, name):
self.name = name
|
1
2
3
4
5
6
7
8
9
|
const hello = () => {
console.log("Hello, World!");
};
async function fetchData() {
const response = await fetch('/api/data');
return response.json();
}
|
1
2
3
4
|
ls -la
grep "error" log.txt
docker-compose up -d
|
1
2
3
|
SELECT * FROM users WHERE age > 18;
UPDATE posts SET title = '新标题' WHERE id = 1;
|
1
2
3
4
5
6
|
public class HelloWorld {
public static void main(String[] args) {
System.out.println("Hello, World!");
}
}
|
1
2
3
4
| | 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |
|
1
2
3
| | 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容1 | 内容2 | 内容3 |
|
1
2
3
4
5
| | 功能 | 命令 | 说明 |
|------|------|------|
| 新建 | `Ctrl+N` | 创建新文件 |
| 保存 | `Ctrl+S` | 保存当前文件 |
| 查找 | `Ctrl+F` | 搜索内容 |
|
1
2
3
4
5
6
7
8
9
10
| > 这是一段引用
> 可以换行
> 多行引用
> 第二行
> 第三行
> 嵌套引用
>> 二级引用
>>> 三级引用
|
1
2
3
4
5
6
7
8
| 这是一个脚注[^1]示例。
[^1]: 这是脚注的内容，会在页面底部显示。
多个脚注[^note1][^note2]
[^note1]: 第一个脚注
[^note2]: 第二个脚注
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| <!-- 颜色 -->
<font color="red">红色文字</font>
<font color="#00ff00">绿色文字</font>
<!-- 大小 -->
<font size="5">大字</font>
<!-- 对齐 -->
<p align="left">左对齐</p>
<p align="center">居中</p>
<p align="right">右对齐</p>
<!-- 换行 -->
<br>
<!-- 隐藏（不显示）-->
<!-- 注释内容 -->
|
居中显示
### 8.2 嵌入视频
1
2
3
4
5
| <!-- B站 -->
<iframe src="//player.bilibili.com/player.html?aid=xxx" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>
<!-- YouTube -->
<iframe width="560" height="315" src="https://www.youtube.com/embed/xxx" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
1
2
3
| 这是行内公式 $E = mc^2$，很酷吧！
行内分数 $\frac{a}{b}$
|
1
2
3
4
5
6
7
| $$
f(x) = \int_{-\infty}^{\infty} \hat{f}(\xi)\,e^{2\pi i \xi x} \,d\xi
$$
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
| $$
\begin{aligned}
a &= b + c \\
&= d + e + f
\end{aligned}
$$
$$
\begin{cases}
x = 2y \\
y = 3z
\end{cases}
$$
$$
\vec{AB} = \vec{B} - \vec{A}
$$
|
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行A]
B -->|否| D[执行B]
C --> E[结束]
D --> E
1
2
3
4
5
6
7
8
9
10
|
**效果：**
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行A]
B -->|否| D[执行B]
C --> E[结束]
D --> E
|
```mermaid
sequenceDiagram
participant A as 用户
participant B as 服务器
participant C as 数据库
A->>B: 发送请求
B->>C: 查询数据
C-->>B: 返回结果
B-->>A: 响应结果
1
2
3
4
5
6
7
8
9
10
11
12
13
|
**效果：**
```mermaid
sequenceDiagram
participant A as 用户
participant B as 服务器
participant C as 数据库
A->>B: 发送请求
B->>C: 查询数据
C-->>B: 返回结果
B-->>A: 响应结果
|
gantt
title 项目计划
dateFormat YYYY-MM-DD
section 需求
需求分析 :a1, 2026-01-01, 7d
原型设计 :after a1, 5d
section 开发
前端开发 :10d
后端开发 :10d
section 测试
联调测试 :5d
上线发布 :2026-02-01, 2d
### 10.4 饼图
pie
title 项目成员
"前端" : 40
"后端" : 35
"测试" : 15
"运维" : 10
---
## 十一、编辑器推荐
### 11.1 Typora（强烈推荐）
> 最喜欢的Markdown编辑器，所见即所得
| 特点 | 说明 |
|------|------|
| 平台 | Windows/Mac/Linux |
| 价格 | 免费/付费 |
| 特点 | 所见即所得，实时预览 |
**快捷键：**
| 快捷键 | 功能 |
|--------|------|
| `Ctrl+B` | 粗体 |
| `Ctrl+I` | 斜体 |
| `Ctrl+K` | 插入链接 |
| `Ctrl+Shift+I` | 插入图片 |
| `Ctrl+L` | 插入链接 |
| `Ctrl+Shift+M` | 代码块 |
| `Ctrl+1-6` | 标题 |
| `Ctrl+0` | 正文 |
### 11.2 VSCode
| 特点 | 说明 |
|------|------|
| 平台 | Windows/Mac/Linux |
| 价格 | 免费 |
| 插件 | Markdown All in One |
**必备插件：**
- **Markdown All in One** - 目录、公式、表格预览
- **Markdown Preview Enhanced** - 增强预览
- **Markdownlint** - 语法检查
- **Mermaid Markdown syntax** - Mermaid支持
### 11.3 其他编辑器
| 编辑器 | 平台 | 特点 |
|--------|------|------|
| **Obsidian** | 全平台 | 双链笔记 |
| **Notion** | Web | 在线协作 |
| **有道云笔记** | 全平台 | 云端同步 |
| **印象笔记** | 全平台 | 知识管理 |
---
## 十二、实用技巧
### 12.1 目录自动生成
### 12.2 锚点链接
1
2
3
| ## 标题 {#custom-id}
[跳转到标题](#custom-id)
|
1
2
3
4
5
| # 方法1: Typora
文件 → 导出 → PDF
# 方法2: VSCode + Chrome
右键 → Open in Browser → 打印为PDF
|
