前置知识

阅读本文前,建议先了解:

  • 无需前置知识,本文专为初学者设计

一、什么是 Markdown?

Markdown 是一种轻量级标记语言,由约翰·格鲁伯(John Gruber)于 2004 年创建。它的设计理念是「易读易写」——用简单的纯文本语法来格式化文档,让人能够快速书写,同时保持良好的可读性。

[!比喻] Markdown 就像… 像「文字的快捷键」——不需要复杂的排版菜单,用几个符号就能告诉电脑:“这是标题”、“这是重点”、“这是代码”。


二、Markdown 解决什么问题?

2.1 以前的痛苦

在 Markdown 出现之前,撰写格式化的文档需要:

方式问题
HTML需要学习各种标签,如 <h1><p><strong>,标签混杂在内容中
Word需要手动点击无数菜单调整字体、段落、对齐方式
LaTeX学术论文排版系统,但学习曲线极其陡峭

2.2 Markdown 的诞生

❌ 以前:为了格式,要学几百个命令/点击几百次菜单
✅ 现在:只要记住 10 个符号,就能写出格式漂亮的文档

三、核心设计理念

Markdown 的设计遵循两个原则:

3.1 易读性优先

Markdown 文件即使没有渲染,原始文本也具有很好的可读性:

# 这是一篇文章
 
## 第一章
 
这是一段正文。这里是**重点**强调。
 
- 列表项 1
- 列表项 2

就算你不懂 Markdown,看这段文字也能猜到:这是标题、这是重点、这是列表

3.2 简单符号化

用日常生活中常见的符号来表示格式:

符号含义示例
#标题# 一级标题
**粗体**粗体**
*斜体*斜体*
-列表- 项目
>引用> 引用内容
`代码`代码`

四、技术原理:Markdown 如何工作?

理解原理能帮助你更好地使用 Markdown:

┌─────────────────────────────────────────────────────────────┐
│                    Markdown 工作流程                         │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   1. 编写阶段                                               │
│   ┌─────────────┐                                           │
│   │ # 标题      │  ← 你用纯文本+符号写文档                    │
│   │ - 列表      │                                           │
│   │ **重点**    │                                           │
│   └──────┬──────┘                                           │
│          ↓                                                   │
│   2. 渲染阶段                                               │
│   ┌─────────────┐                                           │
│   │   标题      │  ← Markdown 解析器                          │
│   │   • 列表    │     把符号转换成 HTML/CSS                   │
│   │   重点      │                                           │
│   └──────┬──────┘                                           │
│          ↓                                                   │
│   3. 显示阶段                                               │
│   ┌─────────────┐                                           │
│   │   📺 渲染后的美丽文档                                     │
│   └─────────────┘                                           │
│                                                             │
└─────────────────────────────────────────────────────────────┘

关键技术点:

  • Markdown 解析器(如 marked、markdown-it)读取 .md 文件
  • 解析符号规则,转换为 HTML
  • 浏览器或阅读器渲染 HTML 为可视化文档

五、应用场景

Markdown 广泛应用于:

场景示例工具
个人笔记Obsidian、Notion、Typora
技术文档GitHub README、API 文档
博客写作Hugo、Hexo、WordPress
论文撰写与 LaTeX 结合使用
AI 对话ChatGPT、Claude 等大模型交互

六、示例演示

# 这是一级标题
 
## 这是二级标题
 
这是普通段落。可以用 **粗体***斜体*~~删除线~~
 
### 列表
 
- 无序列表项 1
- 无序列表项 2
 
1. 有序列表项 1
2. 有序列表项 2
 
### 代码
 
行内代码:`print("Hello")`
 
代码块:
```python
def hello():
    print("Hello, World!")

引用

这是引用内容 可以换行继续

表格

| 列1  | 列2  |
| --- | --- |
| 内容1 | 内容2 |

七、总结

  • Markdown = 轻量级标记语言,用简单符号表示格式
  • 核心理念:「易读易写」,简单但足够
  • 工作原理:用符号写 → 解析器转换 → 渲染为美丽文档
  • 最大优势:几分钟入门,终生受用

一句话:Markdown 用最少的语法,实现最大的灵活性。


八、延伸阅读