Markdown 教程

本教程是 Markdown 的完整 9 篇入门系列，参考 CommonMark 规范与 GitHub Flavored Markdown（GFM）扩展，面向零基础写作者与程序员。从最简单的标题、段落一路讲到表格、引用、Mermaid 图表，每一篇都配有可立即运行的源码示例。

Markdown 是 John Gruber 在 2004 年创建的一种轻量级标记语言，目标是"让写作者专注于内容，而不是格式"。用几个简单符号就能写出结构化文档，然后自动转换为 HTML。它是 GitHub README、技术博客、笔记软件、聊天工具的通用语言。

先看一段 Markdown

下面是一段最简单的 Markdown 源码，先感受一下它的样子：

# 我的第一个 Markdown 文档

大家好，这是我的**第一篇** Markdown 文档。

## 今天学什么

- 标题与段落
- 列表与引用
- `行内代码` 与代码块

```python
print("Hello, Markdown!")
```

全部 9 篇子教程

建议按顺序学习，每篇 5~10 分钟，半天就能入门。

  1. Markdown 简介 — 历史、应用场景与编辑器
  2. 标题、段落与换行 — 基础结构语法
  3. 文本格式 — 粗体、斜体、删除线
  4. 列表 — 有序、无序、任务列表
  5. 链接与图片 — 行内、引用、自动链接
  6. 代码 — 行内代码与代码块
  7. 表格 — 标准表格与对齐
  8. 引用 — 单行、多行、嵌套
  9. GitHub 扩展 — 警告框、脚注、Mermaid

推荐学习路径

如果你是完全的零基础，建议按下面 3 个阶段推进：

每篇都建议边读边敲：把示例源码复制到编辑器（Typora、VS Code、Obsidian 都行），改一改、看看渲染效果。Markdown 是"肌肉记忆"，光看不练记不住。

开始学习

准备好了吗？从第一篇开始 → Markdown 简介

✈️💬