Markdown 完全使用教程：从入门到精通
一、Markdown 简介
Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 HTML 文档。
1.1 为什么选择 Markdown？
- 简单易学：语法简洁，几分钟就能上手
- 跨平台兼容：纯文本格式，任何编辑器都能打开
- 专注内容：不用纠结排版，专心写内容
- 广泛支持：GitHub、知乎、简书、WordPress 等平台都支持
1.2 Markdown 的应用场景
- 技术文档和 README 文件
- 博客文章
- 笔记和备忘录
- 邮件撰写
- 电子书编写
二、基础语法
2.1 标题
Markdown 支持 6 级标题，使用 # 符号表示：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题效果展示：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2.2 段落和换行
段落之间用空行分隔，行尾加两个空格表示换行：
这是第一段。
这是第二段，中间有空行。
这是第三段第一行。
这是第三段第二行（行尾有两个空格）。2.3 强调
斜体
*这是斜体文字*
_这也是斜体文字_效果： 这是斜体文字
粗体
**这是粗体文字**
__这也是粗体文字__效果： 这是粗体文字
粗斜体
***这是粗斜体文字***
___这也是粗斜体文字___效果： 这是粗斜体文字
删除线
~~这是删除线文字~~效果： 这是删除线文字
2.4 列表
无序列表
使用 *、+ 或 - 符号：
* 苹果
* 香蕉
* 橙子
+ 红色
+ 绿色
+ 蓝色
- 第一项
- 第二项
- 第三项效果：
- 苹果
- 香蕉
- 橙子
有序列表
使用数字加英文句点：
1. 第一步
2. 第二步
3. 第三步效果：
- 第一步
- 第二步
- 第三步
嵌套列表
通过缩进实现嵌套：
1. 水果
* 苹果
* 香蕉
2. 蔬菜
* 西红柿
* 黄瓜效果：
- 水果
- 苹果
- 香蕉
- 蔬菜
- 西红柿
- 黄瓜
2.5 链接
行内式链接
[百度](https://www.baidu.com)
[Google](https://www.google.com "谷歌搜索引擎")效果： 百度
参考式链接
[百度][1]
[Google][2]
[1]: https://www.baidu.com "百度搜索引擎"
[2]: https://www.google.com "谷歌搜索引擎"自动链接
<https://www.baidu.com>
<example@email.com>2.6 图片
示例：
2.7 引用
使用 > 符号表示引用：
> 这是一段引用文字。
> 可以有多行。
>
> > 这是嵌套引用。效果：
这是一段引用文字。 可以有多行。
这是嵌套引用。
2.8 代码
行内代码
使用反引号包裹：
使用 `print("Hello World")` 输出文字。效果： 使用 print("Hello World") 输出文字。
代码块
使用三个反引号或四个空格缩进：
```python
def hello():
print("Hello World")
hello()
**效果：**
```python
def hello():
print("Hello World")
hello()指定语言高亮
```javascript
function hello() {
console.log("Hello World");
}
**效果：**
```javascript
function hello() {
console.log("Hello World");
}2.9 分割线
使用三个或更多的 *、- 或 _：
***
---
___效果：
三、高级语法
3.1 表格
使用 | 和 - 创建表格：
| 姓名 | 年龄 | 职业 |
|------|------|------|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 产品经理 |效果：
| 姓名 | 年龄 | 职业 |
|---|---|---|
| 张三 | 25 | 工程师 |
| 李四 | 30 | 设计师 |
| 王五 | 28 | 产品经理 |
对齐方式
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |效果：
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |
3.2 任务列表
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项效果：
- 已完成任务
- 未完成任务
- 待办事项
3.3 脚注
这是一段文字[^1]。
[^1]: 这是脚注内容。3.4 目录
部分编辑器支持自动生成目录：
[TOC]四、扩展语法
4.1 数学公式
使用 LaTeX 语法（部分平台支持）：
行内公式：$E = mc^2$
块级公式：
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$4.2 流程图
使用 Mermaid 语法（部分平台支持）：
```mermaid
graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
C --> D
## 4.3 表情符号
```markdown
:smile: :heart: :thumbsup:效果： 😄 ❤️ 👍
五、技巧实践
5.1 转义字符
使用反斜杠 \ 转义特殊字符：
\*这不是斜体\*
\#这不是标题效果： *这不是斜体*
5.2 HTML 标签
Markdown 支持直接使用 HTML 标签：
<p>这是一段 HTML 段落。</p>
<span style="color: red;">红色文字</span>5.3 注释
<!-- 这是注释，不会显示 -->5.4 实用技巧
技巧 1：快速创建链接
<https://www.example.com>技巧 2：强调嵌套
***粗斜体***
**_粗体斜体_**技巧 3：代码块嵌套
在代码块中显示代码块：
````markdown
```python
print("Hello")六、编辑器推荐
6.1 桌面端编辑器
Typora
- 特点：所见即所得，实时预览
- 平台：Windows、macOS、Linux
- 价格：付费（约 $15）
VS Code
- 特点：功能强大，插件丰富
- 平台：Windows、macOS、Linux
- 价格：免费
- 推荐插件：Markdown All in One、Markdown Preview Enhanced
Obsidian
- 特点：双向链接，知识管理
- 平台：Windows、macOS、Linux
- 价格：免费（个人使用）
6.2 在线编辑器
StackEdit
- 地址：https://stackedit.io
- 特点：功能全面，支持同步
Dillinger
- 地址：https://dillinger.io
- 特点：简洁易用
Cmd Markdown
- 地址：https://www.zybuluo.com
- 特点：中文支持好
6.3 移动端编辑器
iA Writer
- 平台：iOS、Android
- 特点：专注写作体验
Markor
- 平台：Android
- 特点：开源免费
七、Markdown 在 WordPress 中的使用
7.1 为什么在 WordPress 中使用 Markdown？
WordPress 默认的可视化编辑器虽然功能强大，但对于技术博客来说，Markdown 有以下优势：
- 写作效率高：不用频繁点击格式按钮
- 代码展示清晰：原生支持代码块和语法高亮
- 内容可移植：纯文本格式，方便迁移
- 专注内容：减少排版干扰
7.2 推荐插件：Markup Markdown
本博客已安装 Markup Markdown 插件，它是 WordPress 中最优秀的 Markdown 插件之一。
主要功能
- 原生 Markdown 支持：在文章编辑器中直接编写 Markdown
- 实时预览：边写边看效果
- 语法高亮：支持多种编程语言的代码高亮
- 数学公式：支持 LaTeX 数学公式
- 流程图：支持 Mermaid 流程图
使用方法
方法一：在经典编辑器中使用
- 进入「文章」→「写文章」
- 确保编辑器处于「文本」模式（不是「可视化」模式）
- 直接输入 Markdown 语法
- 发布后会自动渲染为 HTML
方法二：在区块编辑器（Gutenberg）中使用
- 添加「Markdown」区块
- 在区块中输入 Markdown 内容
- 实时预览效果
方法三：导入 Markdown 文件
- 准备好
.md文件 - 在编辑器中选择「导入 Markdown」
- 自动转换为 WordPress 文章格式
7.3 最佳实践
1. 代码块展示
使用三个反引号包裹代码，并指定语言：
```php
<?php
function hello_world() {
echo "Hello, WordPress!";
}
**渲染效果：**
```php
<?php
function hello_world() {
echo "Hello, WordPress!";
}2. 图片插入
3. 内部链接
[关于我们](/about)
[联系我们](/contact)4. 注意事项
- 避免混合使用：不要在 Markdown 中混用 HTML 标签，除非必要
- 代码高亮：确保指定正确的语言标识符
- 图片路径：使用绝对路径或 WordPress 媒体库 URL
- 预览检查：发布前使用预览功能检查渲染效果
7.4 常见问题
Q: 为什么我的 Markdown 没有正确渲染？
A: 检查以下几点：
- 确保 Markup Markdown 插件已启用
- 编辑器是否处于正确模式
- 语法是否正确（特别是反引号和缩进）
Q: 如何在 Markdown 中使用短代码（Shortcode）？
A: 可以直接在 Markdown 中插入 WordPress 短代码：
这是一段文字。
这是另一段文字。Q: 代码块的行号如何显示？
A: 在 Markup Markdown 设置中启用「显示行号」选项，或使用以下语法：
```php {linenos=table}
<?php
echo "Hello";
---
# 八、总结速查表
## 8.1 基础语法速查
| 语法 | 示例 | 效果 |
|------|------|------|
| 标题 | `# 标题` | # 标题 |
| 粗体 | `**文字**` | **文字** |
| 斜体 | `*文字*` | *文字* |
| 删除线 | `~~文字~~` | ~~文字~~ |
| 无序列表 | `* 项目` | - 项目 |
| 有序列表 | `1. 项目` | 1. 项目 |
| 链接 | `[文字](URL)` | [文字](URL) |
| 图片 | `` | 图片 |
| 引用 | `> 文字` | > 文字 |
| 行内代码 | `` `代码` `` | `代码` |
| 代码块 | ```` ```代码``` ```` | 代码块 |
## 8.2 扩展语法速查
| 语法 | 说明 |
|------|------|
| 表格 | `\| 表头 \|` |
| 任务列表 | `- [ ] 任务` |
| 脚注 | `[^1]` |
| 数学公式 | `$公式$` |
| 流程图 | ````mermaid` |
## 8.3 常用快捷键
| 功能 | 快捷键 |
|------|--------|
| 粗体 | `Ctrl + B` |
| 斜体 | `Ctrl + I` |
| 标题 | `Ctrl + H` |
| 链接 | `Ctrl + K` |
| 代码 | `Ctrl + Shift + K` |
---
# 结语
Markdown 是一种简单而强大的标记语言，掌握它可以大大提高你的写作效率。无论是写技术文档、博客文章还是日常笔记，Markdown 都能让你专注于内容本身。
希望这篇教程能帮助你快速上手 Markdown。如果有任何问题，欢迎在评论区留言讨论！
---
**参考资源：**
- [Markdown 官方文档](https://daringfireball.net/projects/markdown/)
- [CommonMark 规范](https://commonmark.org/)
- [GitHub Flavored Markdown](https://github.github.com/gfm/)