Markdown Guide

March 13, 2026

Markdown 是一种轻量级标记语言，让你能够使用易于阅读和编写的纯文本格式来撰写文档，然后将其转换为结构化的 HTML。这篇指南将涵盖从基础到高级的所有技巧，助你轻松掌握 Markdown，提升写作体验和文章可读性。让我们开始吧！

一、基础文本格式化

这些是构建文章内容的基本元素。

1. 标题 (Headings)

使用 # 创建标题，一个 # 为一级标题，六个 # 为六级标题。为了 SEO 和文章结构清晰，建议每篇文章只使用一个一级标题 (#)。

# 这是一级标题 (文章主标题)
## 这是二级标题
### 这是三级标题
#### 这是四级标题

2. 强调 (Emphasis)

通过强调文本来吸引读者的注意力。

• 粗体：用于特别重要的关键词。
• 斜体：用于术语、引用或突出显示的词语。
• 删除线：用于表示已修正或不再相关的内容。

*这是斜体文本*
_这也是斜体文本_

**这是粗体文本**
__这也是粗体文本__

***这是粗斜体文本***
___这也是粗斜体文本___

~~这是一个删除线文本~~

3. 段落与换行 (Paragraphs & Line Breaks)

• 新段落：在两行文本之间保留一个空行即可创建一个新段落。
• 强制换行：如果希望在不开始新段落的情况下换行，请在行末添加两个或更多空格。

这是第一行。
这是同一段落的第二行。

这是新段落的第一行。

这是第一行。  
这是紧接着的第二行（强制换行）。

二、内容组织与结构

使用这些元素来组织你的内容，使其更具逻辑性和可读性。

4. 列表 (Lists)

无序列表 (Unordered List)

使用 -、* 或 + 创建无序列表。通过缩进可以创建子列表。

- 项目一
- 项目二
  - 子项目 A
  - 子项目 B

有序列表 (Ordered List)

使用数字加 . 创建有序列表。Markdown 会自动处理数字顺序。

1. 第一步
2. 第二步
   1. 详细步骤 A
   2. 详细步骤 B
3. 第三步

5. 任务列表 (Task Lists)

非常适合用于展示待办事项或步骤清单。

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

6. 引用 (Blockquotes)

使用 > 来引用他人的话、书籍内容或突出显示某段引言。可以嵌套使用。

> “学如逆水行舟，不进则退。”
>
> > 这是一个嵌套引用，用于补充说明。

7. 分割线 (Horizontal Rules)

使用三个或更多的 ---、*** 或 ___ 来创建一条水平分割线，用于在视觉上分隔内容区域。

---

三、链接与多媒体 🔗

8. 链接 (Links)

链接是博客文章中不可或缺的元素。

内嵌式链接 (Inline Links)

这是最常见的链接形式。

欢迎访问我的 [个人博客](https://example.com "博客标题")。

引用式链接 (Reference Links)

当你在文章中多次引用同一个链接时，这种方式能让原文更整洁。

这是一个 [引用链接][1] 的例子，这里是 [另一个][2]。

[1]: https://example.com "示例网站"
[2]: https://anothersite.com "另一个网站"

自动链接 (Automatic Links)

大部分 Markdown 渲染器会自动将 URL 和邮箱地址转换为可点击的链接。

https://google.com
user@example.com

9. 图片 (Images)

图片语法与链接非常相似，只是在前面多一个感叹号 !。替代文本 (Alt text) 对 SEO 和可访问性至关重要。

![替代文本：一只可爱的小猫](https://example.com/image.png "图片标题")

同样可以使用引用式：

![替代文本][logo]

[logo]: https://example.com/logo.png "网站 Logo"

四、代码与技术展示 💻

10. 行内代码 (Inline Code)

使用反引号 ` 包裹简短的代码片段或命令。

在 JavaScript 中，使用 `console.log()` 来打印信息。

11. 代码块 (Code Blocks)

使用三个反引号 ``` 包裹多行代码。强烈建议指定编程语言以获得语法高亮。

```python
def hello_world():
    print("Hello, World!")

hello_world()
```

12. 表格 (Tables)

创建结构化的数据表格。使用冒号 : 来控制对齐方式。

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 单元格 |  单元格  | 单元格 |
| 单元格 |  单元格  | 单元格 |

五、高级与扩展语法

这些语法可能不被所有 Markdown 编辑器支持，但在多数现代博客平台上是可用的。

13. 脚注 (Footnotes)

为文章添加补充说明，让正文保持简洁。

这是一个带有脚注的句子[^1]。

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

14. 定义列表 (Definition Lists)

用于解释一系列术语。

Markdown
: 一种轻量级标记语言。

HTML
: 超文本标记语言。

15. 转义字符 (Escaping Characters)

如果你想显示 Markdown 的特殊字符（如 *、#），可以在其前面加上反斜杠 \。

我想显示一个星号 \*，而不是让它变成斜体。

16. 内嵌 HTML (Inline HTML)

Markdown 是 HTML 的超集，因此你可以直接在其中编写 HTML 代码来实现更复杂的布局（请谨慎使用）。

<p style="color:red;">这是一段红色的文字。</p>

17. 表情符号 (Emoji)

在支持的平台上，可以直接使用 emoji 代码或直接粘贴表情符号。

写作真有趣！ :smile: 😄

Markdown, Writing, Tools