Markdown基础用法

离人发布于 2025-5-27 20:38 阅读：76 学无止境

Markdown：简洁高效的写作利标记语言

在数字化时代，我们需要一种简单而高效的方式来书写和格式化文本。Markdown 应运而生，它以其“易读易写”的特点，迅速成为程序员、作家、博主以及任何需要快速撰写内容的人的宠儿。

Markdown 是一种轻量级标记语言，它允许你使用简单的符号来添加格式，例如标题、列表、粗体、斜体等。它的最大优势在于，你可以使用任何文本编辑器进行编写，并且最终内容可以轻松转换为 HTML、PDF 或其他格式。

为什么选择 Markdown？

易学易用： 学习曲线非常平缓，几分钟就能掌握基本用法。
兼容性强： 几乎所有平台和应用程序都支持 Markdown。
专注于内容： 让你摆脱繁琐的格式设置，专注于写作本身。
版本控制友好： 纯文本格式使其非常适合版本控制工具（如 Git）。
开放标准： 不受特定软件或公司的限制。

Markdown 基本语法

下面将介绍 Markdown 最常用的一些语法。

1. 标题 (Headings)

Markdown 提供了六个级别的标题，对应 HTML 中的 <h1> 到 <h6>。你只需在标题前添加 # 符号，# 的数量代表标题的级别。

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

效果：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

2. 段落 (Paragraphs)

段落是最基本的文本块。在 Markdown 中，只需在两行之间保留一个空行，即可创建新的段落。

这是第一个段落。

这是第二个段落。

效果：

这是第一个段落。

这是第二个段落。

3. 强调 (Emphasis)

粗体 (Bold)： 使用两个星号 ** 或两个下划线 __ 包裹文本。
```
**这是粗体文本**
__这也是粗体文本__
```
效果：

这是粗体文本
这也是粗体文本
斜体 (Italic)： 使用一个星号 * 或一个下划线 _ 包裹文本。
```
*这是斜体文本*
_这也是斜体文本_
```
效果：

这是斜体文本
这也是斜体文本
粗体加斜体： 结合使用。
```
***这是粗体加斜体***
___这也是粗体加斜体___
```
效果：

这是粗体加斜体
这也是粗体加斜体

4. 列表 (Lists)

Markdown 支持无序列表和有序列表。

无序列表 (Unordered Lists)： 使用星号 *、加号 + 或短横线 - 作为列表标记。
```
* 项目一
* 项目二
    * 子项目二之一步骤一
    * 子项目二之一步骤二
+ 项目三
- 项目四
```
效果：
- 项目一
- 项目二
  - 子项目二之一步骤一
  - 子项目二之一步骤二
- 项目三
- 项目四
有序列表 (Ordered Lists)： 使用数字后跟一个句点 .。
```
1. 第一项
2. 第二项
    1. 第二项的子项一
    2. 第二项的子项二
3. 第三项
```
效果：
1. 第一项
2. 第二项
  1. 第二项的子项一
  2. 第二项的子项二
3. 第三项

5. 链接 (Links)

你可以创建行内链接和参考式链接。

行内链接： [链接文本](链接地址 "可选标题")
```
这是一个[谷歌链接](https://www.google.com "谷歌官网")。
```
效果：

这是一个谷歌链接。
参考式链接： 适用于多次引用同一链接时。
```
我经常访问[谷歌][1]和[百度][2]。
```
效果：

我经常访问谷歌和百度。

6. 图片 (Images)

图片语法与链接类似，只是在链接前多了一个感叹号 !。

![图片描述](图片地址 "可选标题")

![Markdown Logo](https://markdown.com.cn/images/logo.png "Markdown")

效果：

7. 代码 (Code)

行内代码： 使用反引号 ` 包裹代码。
```
`print("Hello, Markdown!")`
```
效果：

print("Hello, Markdown!")

代码块： 使用三个反引号 `````

 ``` 包裹代码块，并可以在第一个反引号后指定语言，实现代码高亮。

````markdown
```python
def factorial(n):
    if n == 0:
        return 1
    else:
        return n * factorial(n-1)

print(factorial(5))


**效果：**

```python
def factorial(n):
    if n == 0:
        return 1
    else:
        return n * factorial(n-1)

print(factorial(5))

8. 引用 (Blockquotes)

使用 > 符号来引用文本。

> 这是引用的内容。
>
> > 这是嵌套的引用。

效果：

这是引用的内容。

这是嵌套的引用。

9. 分隔线 (Horizontal Rules)

使用三个或更多个星号 ***、短横线 --- 或下划线 ___ 来创建分隔线。

***
---
___

效果：

进阶用法 (CommonMark / GFM 扩展)

除了上述基本语法，许多 Markdown 解析器还支持一些扩展语法，其中最常见的是 CommonMark 和 GitHub Flavored Markdown (GFM)。

1. 表格 (Tables)

使用 | 来分隔列，使用 - 来分隔表头和内容。

| 列一 | 列二 | 列三 |
|------|------|------|
| 内容1 | 内容2 | 内容3 |
| 内容4 | 内容5 | 内容6 |

效果：

列一	列二	列三
内容1	内容2	内容3
内容4	内容5	内容6

你可以通过在 - 线的两端或左侧、右侧添加 : 来控制对齐方式。

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1   |  内容2   |  内容3 |
| 内容4   |  内容5   |  内容6 |

效果：

左对齐	居中对齐	右对齐
内容1	内容2	内容3
内容4	内容5	内容6

2. 任务列表 (Task Lists)

在列表项前加上 [ ] 或 [x] 来创建任务列表。

- [x] 完成任务一
- [ ] 完成任务二
- [ ] 完成任务三

效果：

[x] 完成任务一
[ ] 完成任务二
[ ] 完成任务三

3. 删除线 (Strikethrough)

使用两个波浪线 ~~ 包裹文本。

~~这是要删除的文本~~

效果：

~~这是要删除的文本~~

Markdown 工具推荐

在线编辑器： Typora (支持实时预览，所见即所得)、Dillinger、StackEdit
本地编辑器： VS Code (配合 Markdown 插件)、Obsidian、Joplin
集成开发环境 (IDE)： 许多 IDE 都内置了 Markdown 支持或提供相关插件。