Markdown 入门指南：从零到一轻松掌握

目录

1. 什么是 Markdown？
2. 为什么使用 Markdown？

3. 基础语法

   • 标题
   • 段落与换行
   • 文本样式（粗体、斜体、删除线）
   • 列表（有序与无序）
   • 链接
   • 图片
   • 引用
   • 代码（行内与块）
   • 分割线

4. 进阶语法

   • 表格
   • 任务列表
   • 转义字符
5. 最佳实践与工具
6. 总结

---

1. 什么是 Markdown？

Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它允许人们使用易读易写的纯文本格式编写文档，然后转换成结构化的、格式丰富的 HTML 页面。

简单来说，你用一些简单的符号（如 *、#、>）来标记文本，Markdown 解析器就能理解这些标记并将其渲染成漂亮的格式。

2. 为什么使用 Markdown？

• 语法简单：几分钟就能上手，常用语法不超过十个。
• 专注内容：让你摆脱复杂的排版工具，专注于写作本身。
• 可读性强：即使是源码，也具有良好的可读性。
• 平台通用：GitHub、GitLab、Jira、Typora、Obsidian、各种技术论坛和博客平台都广泛支持。
• 易于转换：可以轻松转换为 HTML、PDF、Word 等多种格式。

3. 基础语法

标题

使用 # 号来创建标题，一个 # 代表一级标题，两个 ## 代表二级标题，以此类推，最多支持六级标题。

语法示例：

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

渲染效果：

这是一级标题

这是二级标题

这是三级标题

...

注意：# 和标题文本之间最好有一个空格，这是最规范的写法。

段落与换行

一个段落是由一个或多个连续的文本行组成。若要创建一个新的段落，只需在段落之间留一个空行即可。

如果你想在段落内强制换行（而不是开始一个新段落），可以在行尾输入两个或更多的空格，然后回车。

语法示例：

这是第一个段落。

这是第二个段落。

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

文本样式

使用星号 * 和波浪线 ~ 来设置文本样式。

• 斜体：用一个 * 或 _ 包裹文本。
• 粗体：用两个 ** 或 __ 包裹文本。
• 粗斜体：用三个 *** 或 ___ 包裹文本。
• 删除线：用两个 ~~ 包裹文本。

语法示例：

*这是斜体*
_这也是斜体_

**这是粗体**
__这也是粗体__

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

~~这是删除线~~

渲染效果：
这是斜体
这是粗体
这是粗斜体
这是删除线

列表

无序列表

使用 *、+ 或 - 来创建无序列表。符号和文本之间需要一个空格。

语法示例：

- 苹果
- 香蕉
  - 黄香蕉
  - 青香蕉
- 橙子

* 项目一
* 项目二

有序列表

使用数字加一个英文句点 . 来创建有序列表。

语法示例：

1. 打开冰箱
2. 把大象放进去
3. 关上冰箱

技巧：即使你写的数字是 1. 1. 1.，Markdown 也会自动渲染成 1. 2. 3.。

链接

链接的语法是 [链接文本](链接地址 "可选的标题")。

语法示例：

[访问谷歌](https://www.google.com "Google 搜索")

图片

图片的语法与链接非常相似，只是在前面多一个感叹号 !。语法是 ![替代文本](图片地址 "可选的标题")。

• 替代文本(Alt Text)：当图片无法加载时显示的文字。
• 可选的标题：当鼠标悬停在图片上时显示的文字。

语法示例：

![Markdown Logo](https://markdown.com.cn/assets/img/markdown-mark.svg "Markdown 标志")

引用

使用大于号 > 来创建引用块。可以嵌套使用。

语法示例：

> 这是一个引用。
>
> > 这是一个嵌套的引用。

代码

行内代码

使用一对反引号 ` 来包裹行内代码。

语法示例：

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

代码块

使用三对反引号 来创建代码块，并可以在第一组反引号后指定语言，以实现语法高亮。

语法示例：

function greet() {
  console.log("Hello, Markdown!");
}
greet();

Use code with caution.
Markdown
分割线
使用三个或更多的 *、- 或 _ 来创建一条水平分割线。

语法示例：

---

---

_
Use code with caution.
Markdown

4. 进阶语法
   表格
   表格语法稍微复杂一些，使用竖线 | 分隔单元格，使用短横线 - 分隔表头和表体。

语法示例：

左对齐	居中对齐	右对齐
单元格1	单元格2	单元格3
单元格4	单元格5	单元格6

Use code with caution.
Markdown
提示：冒号 : 的位置决定了对齐方式。:--- 表示左对齐（默认），:---: 表示居中对齐，---: 表示右对齐。
任务列表
这是 Markdown 的一个扩展功能（在 GitHub、GitLab 等平台常用），可以在列表项中创建复选框。

语法示例：

• [x] 完成 Markdown 教程的学习
• [ ] 开始写第一篇 Markdown 博客
• [ ] 喝杯咖啡
  Use code with caution.
  Markdown
  转义字符
  如果你想显示 Markdown 语法中用到的特殊字符（如 *, #, [ 等），可以在字符前加上反斜杠 \。

语法示例：

我想显示一个星号 * 和一个井号 \#。
我想显示 \[ 而不是链接。
Use code with caution.
Markdown

5. 最佳实践与工具
   空行分隔：养成在不同逻辑块之间使用空行的习惯，这能让你的源文件更清晰，也能避免一些渲染错误。
   了解 "方言"：Markdown 有不同的 "方言"，如 CommonMark、GitHub Flavored Markdown (GFM) 等。它们在基础语法上一致，但在表格、任务列表等进阶功能上略有差异。GFM 是目前最流行的方言。
   推荐工具：
   编辑器：
   Typora：所见即所得的编辑器，对新手非常友好。（目前已收费）
   VS Code：强大的代码编辑器，安装 Markdown All in One 等插件后体验极佳。
   Obsidian：强大的双链笔记软件，原生支持 Markdown。
   在线编辑器：
   StackEdit.io：功能齐全的在线 Markdown 编辑器。
   Dillinger.io：简洁的在线编辑器，支持分屏预览。
6. 总结
   恭喜你！你已经掌握了 Markdown 的核心知识。

Markdown 的精髓在于它的简洁和高效。现在，最好的学习方法就是立刻开始使用它！无论是写笔记、写文档，还是在论坛发言，都尝试用 Markdown 来格式化你的文本吧。熟能生巧！