Markdown 入门与进阶实战教程#

1. 安装编辑器#

• VS Code 下载地址： https://code.visualstudio.com/

2. 推荐插件#

• Markdown All in One：快捷键、目录生成、列表增强。
• Markdown Preview Enhanced：预览增强、数学公式、图表支持。
• Paste Image：快速粘贴图片并自动生成链接。
• Markdown PDF（可选）：导出 PDF，但复杂样式时不一定稳定。

3. 基本工作流#

1. 新建 xxx.md 文件。
2. 使用 VS Code 预览：Ctrl+Shift+V。
3. 左边写作，右边预览，边改边看。

1. 标题#

1
# 一级标题
2
## 二级标题
3
### 三级标题

建议一篇文章只使用一个一级标题，正文从二级标题开始。

2. 段落与换行#

• 空一行表示新段落。
• 行尾加两个空格再回车表示强制换行。
• 分割线常用 --- 或 ***。

3. 引用#

1
> 一级引用
2
>> 二级引用

示例：

这是一级引用。

这是二级引用。

4. 列表#

无序列表可用 -、*、+，建议统一一种风格：

1
- 列表项 A
2
- 列表项 B
3
  - 子项 B1

有序列表：

1
1. 第一步
2
2. 第二步
3
3. 第三步

任务列表（Todo）：

1
- [x] 已完成
2
- [ ] 未完成

5. 文本强调#

说明：<u>下划线</u> 这类 HTML 标签也可用，但不同平台兼容性略有差异。

6. 代码块#

建议给代码块加语言标识，方便高亮：

1
#include <iostream>
2
using namespace std;
3

4
int main() {
5
  cout << "hello world" << endl;
6
  return 0;
7
}

行内代码示例：print("hello world");

7. 表格#

1
| 左对齐 | 居中对齐 | 右对齐 |
2
| :-- | :--: | --: |
3
| a | b | c |

8. 链接与图片#

行内链接：

1
[Markdown 教程](https://www.runoob.com/markdown/md-tutorial.html)

引用式链接：

1
查看更多请看[教程][md-guide]
2

3
[md-guide]: https://www.runoob.com/markdown/md-tutorial.html

图片：

1
![图片说明](https://example.com/demo.png)

可点击放大图：

1. 数学公式（LaTeX）#

• 行内公式：$f(x)=ax+b$
• 块级公式：

2. HTML 混写#

Markdown 中可以直接写 HTML，例如居中图片：

适用场景：Markdown 语法不够表达时，用 HTML 补充。

1. 目录点击不跳转#

原因：标题锚点与目录链接不一致。
建议：先确定标题文本，再复制自动生成的锚点。

2. 表格错位#

原因：中英文字符宽度混合、列数不一致。
建议：先保证每行列数一致，再调整对齐符号。

3. 代码不高亮#

原因：代码块没写语言标识。
建议：把 改为js、cpp、bash 等。

4. 公式不渲染#

原因：预览器或站点未启用数学插件。
建议：确认你的 Markdown 渲染环境支持 KaTeX/MathJax。