📖 什么是 Markdown？
Markdown 是一种轻量级标记语言，用简单的符号就能实现排版效果。它易读易写，是编写博客、文档、笔记的绝佳工具。
📝 基础语法
1. 标题
code
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
code
这是第一段文字。
这是第一段的第二行（同一个段落，会自动换行）。
这是第二段文字（空一行表示新段落）。
这是第三段，
在行尾加两个空格可以实现强制换行（部分编辑器支持）。
像这样。
效果：
这是第一段文字。 这是第一段的第二行（同一个段落，会自动换行）。
这是第二段文字（空一行表示新段落）。
这是第三段，
在行尾加两个空格可以实现强制换行（部分编辑器支持）。
像这样。
3. 强调文字
code
**粗体文本** 或 __粗体文本__
*斜体文本* 或 _斜体文本_
***粗斜体文本*** 或 ___粗斜体文本___
~~删除线文本~~
==高亮文本==（部分编辑器支持）
效果：
粗体文本 或 粗体文本
斜体文本 或 斜体文本
粗斜体文本 或 粗斜体文本
删除线文本
==高亮文本==（部分编辑器支持）
4. 列表
无序列表
code
- 项目一
- 项目二
- 子项目一
- 子项目二
- 孙子项目
- 项目三
或使用 * 或 +
* 星号列表
+ 加号列表
效果：
- 项目一
- 项目二
- 子项目一
- 子项目二
- 孙子项目
- 项目三
或使用 * 或 +
- 星号列表
- 加号列表
有序列表
code
1. 第一项
2. 第二项
1. 子项一
2. 子项二
3. 第三项
注意：数字可以不连续
1. 项目一
3. 项目二
7. 项目三
效果：
- 第一项
- 第二项
- 子项一
- 子项二
- 第三项
5. 引用
code
> 这是一级引用
>> 这是二级引用（嵌套引用）
>>> 这是三级引用
>
> 引用内可以包含其他Markdown格式，如**粗体**、*斜体*等。
效果：
这是一级引用
这是二级引用（嵌套引用）
这是三级引用
引用内可以包含其他Markdown格式，如粗体、斜体等。
6. 代码
行内代码
code
使用反引号包裹代码：`console.log("Hello World")`
效果：
使用反引号包裹代码：console.log("Hello World")
代码块
```javascript
// 指定语言（语法高亮）
function hello() {
console.log("Hello Markdown!");
return true;
}
```
```python
# Python示例
def greet(name):
print(f"Hello, {name}!")
return True
```
```
没有指定语言的普通代码块
print("Just plain text")
```
效果：
javascript
// 指定语言（语法高亮）
function hello() {
console.log("Hello Markdown!");
return true;
}
python
# Python示例
def greet(name):
print(f"Hello, {name}!")
return True
code
没有指定语言的普通代码块
print("Just plain text")
7. 链接
code
[链接文字](https://example.com "可选标题")
[相对链接](./docs/readme.md)
[引用式链接][1]
[1]: https://example.com "示例网站"
直接显示链接：<https://example.com>
或 <email@example.com>
效果： 链接文字
直接显示链接：https://example.com 或 email@example.com
8. 图片
code
带链接的图片：
[](https://example.com)
引用式图片：
![替代文字][logo]
[logo]: https://via.placeholder.com/150 "Logo"
效果：
9. 表格
code
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 | 单元格 | 单元格 |
| 长文本示例 | 这里居中 | 1234 |
效果：
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 单元格 | 单元格 | 单元格 |
| 长文本示例 | 这里居中 | 1234 |
更复杂的表格：
code
| 姓名 | 年龄 | 职业 |
|------|------|------|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 教师 |
效果：
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 教师 |
10. 任务列表
code
- [ ] 未完成任务
- [x] 已完成任务
- [ ] 另一个任务
- [x] 另一个已完成任务
效果：
- 未完成任务
- 已完成任务
- 另一个任务
- 另一个已完成任务
11. 脚注
code
这是一个带有脚注的示例[^1]。
这是另一个脚注[^2]。
[^1]: 这是第一个脚注的内容。
[^2]: 这是第二个脚注的内容，可以很长。
可以多行书写。
效果： 这是一个带有脚注的示例1。
这是另一个脚注2。
12. 分割线
code
---
***
___
效果： 上面是三个相同的分割线
13. 定义列表（部分编辑器支持）
code
术语一
: 定义一
术语二
: 定义二的第一部分
: 定义二的第二部分
效果： 术语一 : 定义一
术语二 : 定义二的第一部分 : 定义二的第二部分
14. 数学公式（需支持KaTeX或MathJax）
code
行内公式：$E = mc^2$
块级公式：
$$
\int_a^b f(x)dx = F(b) - F(a)
$$
矩阵：
$$
\begin{bmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{bmatrix}
$$
效果： 行内公式：
块级公式：
矩阵：
15. 转义字符
code
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 花括号
\[\] 方括号
\(\) 括号
\# 井号
\+ 加号
\- 减号
\. 句点
\! 感叹号
效果： *这不会被解析为斜体*
🔧 高级技巧
1. 目录（部分编辑器支持）
code
[TOC]
或
[[TOC]]
2. 注音符号（部分编辑器支持）
code
Markdown[^ma:kdɑ:n]
效果： Markdown[^ma:kdɑ:n]
3. 缩写（部分编辑器支持）
code
*[HTML]: HyperText Markup Language
*[CSS]: Cascading Style Sheets
HTML 和 CSS 是现代网页的基础。
效果： *[HTML]: HyperText Markup Language *[CSS]: Cascading Style Sheets
HTML 和 CSS 是现代网页的基础。
4. 嵌入HTML
code
<p style="color: blue;">这是蓝色文字</p>
<div style="background-color: #f0f0f0; padding: 10px;">
这是一个带样式的div
</div>
效果：
这是蓝色文字
这是一个带样式的div
📋 最佳实践
1. 标题层级
- 从一级标题开始，层级不要跳级
- 保持标题层级清晰
2. 列表格式
- 使用一致的符号（如始终使用
-或*） - 缩进使用两个空格或一个制表符
3. 链接管理
- 对于长文档，使用引用式链接便于管理
- 为链接添加描述性文字
4. 代码块
- 始终指定语言以获得语法高亮
- 避免在代码块中使用特殊符号
5. 表格
- 使用表格生成工具或编辑器插件创建复杂表格
- 保持表格内容简洁
6. 兼容性
- 不同平台对Markdown的支持不同
- 复杂的格式（如数学公式）需要确认平台支持
🛠️ 常用工具
-
编辑器：
- VS Code（安装Markdown插件）
- Typora（所见即所得）
- Obsidian（知识管理）
- Notion（在线协作）
-
转换工具：
- Pandoc（格式转换）
- Markdown to PDF/HTML转换器
-
在线编辑器：
- StackEdit
- Dillinger
- Markdown Here（浏览器插件）
💡 实战示例
一篇完整的博客文章结构：
markdown
# 文章标题
> 引言或摘要
## 目录
- [背景介绍](#背景介绍)
- [主要内容](#主要内容)
- [结论](#结论)
## 背景介绍
这里是第一段内容...
## 主要内容
### 子标题一
1. 第一点
2. 第二点
### 子标题二
- 要点一
- 要点二
```python
# 代码示例
def example():
return "Hello"
结论
总结全文...
标签：教程，Markdown，写作
发布时间：2026年1月
作者：忘忧