一、什么是 Markdown？为什么要学？

1. 基础概念

2. 学习价值

1. 1. • 效率提升：无需鼠标点击工具栏，纯键盘输入即可完成排版。
      • 多平台兼容：从写作到编程文档，从博客到笔记软件，几乎所有场景都支持。
      • 轻量化存储：生成的.md 文件体积小，便于版本管理（如配合 Git）。

二、Markdown 核心语法：10 分钟掌握基础

1. 标题（层级分明）

# 一级标题（通常用于文章标题）
## 二级标题（章节标题）
### 三级标题（小节标题）
#### 四级标题（更细分内容）

一级标题

二级标题

2. 文本格式（加粗、斜体、删除线）

**加粗文本**（用两个星号包裹）  
*斜体文本*（用单个星号包裹）  
~~删除线文本~~（用两个波浪线包裹）  
`行内代码`（用单个反引号包裹，用于引用代码或术语）

3. 列表（有序 / 无序）

1. 1. • 无序列表（用-、*或+开头，后接空格）：

- 列表项1
- 列表项2
  - 子列表项（缩进两个空格）
- 列表项3

1. 1. • 列表项 1
      • 列表项 2
        • 子列表项
      • 列表项 3
      • 有序列表（用数字加.开头）：

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

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

4. 链接与图片（插入外部资源）

1. 1. • 链接：[链接文字](网址)
        例：[知乎](https://www.zhihu.com) → 知乎
      • 图片：![图片描述](图片网址)
        例：![Markdown图标](https://example.com/markdown.png)

5. 引用与代码块（突出特殊内容）

1. 1. • 引用（用>开头，用于引用他人观点或文献）：

> 这是一段引用内容，  
> 可以换行继续引用。

这是一段引用内容，
可以换行继续引用。

1. 1. • 代码块（用三个反引号 ``` 包裹，可指定编程语言）：

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

**效果**：  
```python
def hello_world():
    print("Hello, Markdown!")

6. 表格（结构化数据展示）

| 姓名 | 年龄 | 职业       |
|------|------|------------|
| 张三 | 25   | 工程师     |
| 李四 | 30   | 设计师     |

三、编辑器选择：从入门到进阶

1. 新手首选（简单易用）

1. 1. • Typora（Windows/macOS）：
        • 特点：实时预览（输入语法立即看到效果），界面极简，支持导出 PDF/Word。
        • 下载：官网
      • 飞书文档 / 语雀（网页端）：
        • 特点：在线协作，自动保存，适合团队办公，内置 Markdown 模板。

2. 进阶工具（适合程序员 / 深度用户）

1. 1. • VS Code（跨平台）：
        • 特点：安装 “Markdown All in One” 插件后，支持语法高亮、大纲预览、快捷键强化。
      • Obsidian（知识管理）：
        • 特点：以 Markdown 为基础的笔记软件，支持双链（链接不同笔记），适合构建知识体系。

3. 移动端（随时编辑）

1. 1. • Joplin（Android/iOS）：开源免费，支持同步到云端（如坚果云）。
      • iA Writer（iOS/macOS）：专注写作，界面无干扰，语法提示清晰。

四、实战步骤：5 分钟写出第一个 Markdown 文档

1. 下载并安装编辑器（以 Typora 为例）

1. 1. • 打开官网下载对应系统版本，安装后打开软件，界面空白处即可开始输入。

2. 尝试基础排版

1. 1. • 输入# 我的第一个Markdown文档，按回车，自动生成一级标题。
      • 输入- 今天要完成的任务：，按回车，输入任务内容（如 “学习 Markdown 基础语法”）。
      • 输入**重点：** 语法只需记住常用符号，不用死记硬背。，查看加粗效果。

3. 保存与导出

1. 1. • 点击左上角 “文件”→“保存”，默认格式为.md。
      • 若需导出为 Word/PDF，点击 “文件”→“导出”，选择对应格式即可。

五、常见问题与避坑指南

1. 1. 1. 语法不生效？
         • 检查符号是否为英文状态（如# vs ＃），部分输入法可能默认中文符号。
         • 确认编辑器是否开启 “Markdown 模式”（如 VS Code 需手动切换语言模式）。
      2. 复杂格式不会写？
         • 遇到表格、公式等复杂内容，可先用编辑器自带的 “快捷插入” 功能（如 Typora 中点击菜单栏 “表格”→“插入表格”，自动生成语法框架）。
      3. 如何快速记忆语法？
         • 制作一张语法速查表（如下），贴在电脑旁，边用边记：

           功能	语法示例
           标题	# 一级标题
           加粗	**加粗**
           无序列表	- 列表项
           链接	[文字](网址)
           代码块	python\n代码...\n

六、进阶方向：从入门到精通

1. 1. 学习扩展语法
      • Markdown 标准语法之外，部分编辑器支持扩展功能，如：
        • 脚注：[^1]（用于学术写作）
        • 数学公式：用$$包裹 LaTeX 公式（如$$E=mc^2$$）
      • 推荐教程：Markdown 进阶语法指南
   2. 结合工具链提升效率
      • 用 “Markdown + 图床” 插入网络图片（如 PicGo 工具）；
      • 用 “Markdown + Pandoc” 转换为任意格式（支持复杂文档转换）。

七、学习资源推荐

• • 入门教程：
    • Markdown 官方指南（简洁权威）
    • 菜鸟教程 Markdown 篇（中文图文详解）