Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。本文将详细介绍Markdown的各种语法,帮助你快速掌握这个强大的文档编写工具!

1. 什么是Markdown?

Markdown由John Gruber在2004年创建,其设计目标是实现「易读易写」。它使用简单的语法来格式化文本,然后可以转换为HTML或其他格式。

2. 基础语法

2.1 标题

使用#符号来创建标题,支持1-6级标题:

语法示例:

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

渲染效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2.2 文本格式

  • 粗体文本:使用**文本**__文本__
  • 斜体文本:使用*文本*_文本_
  • 粗斜体:使用***文本***
  • 删除线:使用~~文本~~
  • 行内代码:使用反引号包围

2.3 列表

2.3.1 无序列表

使用-*+创建:

语法示例:

- 项目1
- 项目2
  - 子项目2.1
  - 子项目2.2
- 项目3

渲染效果:

  • 项目1
  • 项目2
    • 子项目2.1
    • 子项目2.2
  • 项目3

2.3.2 有序列表

使用数字加点:

语法示例:

1. 第一项
2. 第二项
   1. 子项目2.1
   2. 子项目2.2
3. 第三项

渲染效果:

  1. 第一项
  2. 第二项
    1. 子项目2.1
    2. 子项目2.2
  3. 第三项

2.4 链接和图片

2.4.1 链接

语法示例:

[链接文本](URL "可选标题")
[GitHub](https://github.com "全球最大的代码托管平台")

渲染效果: GitHub

2.4.2 图片

语法示例:

![替代文本](图片URL "可选标题")
![示例图片](https://via.placeholder.com/150x100/4CAF50/FFFFFF?text=Markdown "示例图片")

渲染效果: 示例图片

2.5 引用

使用>创建引用块:

语法示例:

> 这是一个引用块。
> 
> 可以包含多个段落。
> 
> > 这是嵌套引用。

渲染效果:

这是一个引用块。

可以包含多个段落。

这是嵌套引用。

2.6 代码块

2.6.1 行内代码

语法示例:

使用反引号:`console.log('Hello World')`

渲染效果: 使用反引号:console.log('Hello World')

2.6.2 代码块

语法示例:

```javascript
function greet(name) {
    console.log(`Hello, ${name}!`);
}

greet('Markdown');
```

```python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))
```

渲染效果:

function greet(name) {
    console.log(`Hello, ${name}!`);
}

greet('Markdown');
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)

print(fibonacci(10))

3. 高级语法

3.1 表格

语法示例:

| 语法 | 说明 | 示例 |
|------|------|------|
| `**文本**` | 粗体 | **粗体文本** |
| `*文本*` | 斜体 | *斜体文本* |
| `~~文本~~` | 删除线 | ~~删除文本~~ |
| `` `代码` `` | 行内代码 | `console.log()` |

渲染效果: | 语法 | 说明 | 示例 | |——|——|——| | **文本** | 粗体 | 粗体文本 | | *文本* | 斜体 | 斜体文本 | | ~~文本~~ | 删除线 | 删除文本 | | `代码` | 行内代码 | console.log() |

3.2 分隔线

语法示例:

使用三个或更多的`-``*``_`
---

渲染效果: 使用三个或更多的-*_


3.3 任务列表

语法示例:

- [x] 已完成的任务
- [ ] 未完成的任务
- [x] 另一个已完成的任务

渲染效果:

  • 已完成的任务
  • 未完成的任务
  • 另一个已完成的任务

3.4 脚注

语法示例:

这里有一个脚注[^1],还有另一个脚注[^note]。

[^1]: 这是第一个脚注的内容。
[^note]: 这是命名脚注的内容。

渲染效果: 这里有一个脚注1,还有另一个脚注2

4. 扩展语法

4.1 数学公式

语法示例:

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

块级公式:
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

渲染效果: 行内公式:$E = mc^2$

块级公式: \(\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n\)

4.2 高亮文本

语法示例:

==高亮文本==(部分编辑器支持)

渲染效果: ==高亮文本==(部分编辑器支持)

4.3 上标和下标

  • 上标:x^2^
  • 下标:H~2~O

5. 常用工具推荐

5.1 编辑器

  • Typora:所见即所得的Markdown编辑器
  • Mark Text:实时预览的开源编辑器
  • Visual Studio Code:配合Markdown插件使用
  • Obsidian:知识管理和笔记工具

5.2 在线工具

  • Dillinger:在线Markdown编辑器
  • StackEdit:功能丰富的在线编辑器
  • Markdown Live Preview:实时预览工具
  1. 这是第一个脚注的内容。 

  2. 这是命名脚注的内容。