Markdown 安装使用教程

一、Markdown 简介

Markdown 是一种轻量级标记语言，语法简洁、易读易写，广泛用于编写博客、文档、README 文件等。它可以导出为 HTML、PDF 等格式，兼容各种平台如 GitHub、Typora、VSCode 等。

---

二、Markdown 编辑器推荐

2.1 桌面端

编辑器	平台	特点
Typora	Windows/macOS/Linux	所见即所得，简洁高效
VSCode + 插件	跨平台	强大可扩展，开发者首选
Mark Text	跨平台	开源免费，体验良好

2.2 在线编辑器

• https://dillinger.io/
• https://stackedit.io/
• https://markdown.live/

---

三、安装 Markdown 编辑器

3.1 安装 Typora（推荐）

1. 访问官网：https://typora.io/
2. 下载对应平台安装包；
3. 安装后即可开始编写 Markdown 文档；
4. 支持导出 PDF、HTML、Word 等格式。

3.2 安装 VSCode + Markdown 插件

1. 安装 VSCode：https://code.visualstudio.com/
2. 打开插件市场，搜索并安装以下插件：
   • Markdown All in One
   • Markdown Preview Enhanced
3. 支持实时预览、导出 PDF 等功能。

---

四、Markdown 基本语法

4.1 标题

# 一级标题
## 二级标题
### 三级标题

4.2 粗体 / 斜体

**粗体**
*斜体*

4.3 列表

- 无序列表项1
- 无序列表项2

1. 有序列表项1
2. 有序列表项2

4.4 链接与图片

[链接文本](https://example.com)
![图片描述](https://example.com/image.jpg)

4.5 代码块

```java
public class Hello {
public static void main(String[] args) {
System.out.println(“Hello Markdown”);
}
}
```

---

五、Markdown 表格语法

| 姓名 | 年龄 | 城市 |
|------|------|------|
| 小奇 | 25   | 北京 |

---

六、导出 Markdown 为 PDF

6.1 使用 Typora 导出

• 文件 > 导出 > PDF、HTML、Word；

6.2 使用 VSCode 插件导出

• 使用快捷键或命令面板执行 Markdown PDF: Export (pdf)；

---

七、进阶技巧

• 使用 Mermaid 绘制流程图；
• 使用 KaTeX/MathJax 插入数学公式；
• 使用 HTML 标签嵌套增强表现力；

---

八、常见问题

Q1: Markdown 在 GitHub 上样式不一致？

GitHub 使用 GitHub Flavored Markdown（GFM）标准，注意兼容性语法，如表格、任务列表等。

Q2: 如何插入本地图像？

使用相对路径：

![logo](./images/logo.png)

---

九、学习资源推荐

• Markdown 官方文档
• Markdown 中文教程
• Typora 教程
• B站搜索“小奇Java面试”查看 Markdown 视频教学

---

本文由“小奇Java面试”原创发布，转载请注明出处。

可以搜索【小奇JAVA面试】第一时间阅读，回复【资料】获取福利，回复【项目】获取项目源码，回复【简历模板】获取简历模板，回复【学习路线图】获取学习路线图。