Markdown

1. Markdown 是什么？

Markdown 由 John Gruber 和 Aaron Swartz 在 2004 年创建，是一种轻量级标记语言，旨在让用户以纯文本的方式编写格式化文档，同时保持易读性和易写性。它的设计理念是“内容与格式分离”，用户只需使用简单的标记符号（如 #、* 等）即可定义标题、列表、链接等格式，生成的文档可以轻松转换为 HTML、PDF 或其他格式。

特点：

• 简单易学：语法直观，学习曲线平缓。
• 跨平台支持：几乎所有现代编辑器和平台（如 GitHub、Jupyter Notebook、Notion、VS Code）都支持 Markdown。
• 可读性强：即使不渲染，Markdown 源文件也易于阅读。
• 灵活性：可以嵌入 HTML 代码，扩展功能。
• 用途广泛：常用于技术文档、博客、README 文件、笔记整理等。

应用场景：

• 编程相关：GitHub README、Jupyter Notebook 文档、API 文档。
• 写作：博客（如 Hugo、Jekyll）、技术文章。
• 笔记：Obsidian、Notion 等工具中的知识管理。
• 学术：撰写论文草稿或实验报告。

---

2. Markdown 的基础语法

以下是 Markdown 的核心语法，涵盖了最常用的格式化功能。我会逐一讲解，并提供示例代码和渲染效果的说明。

2.1 标题（Headers）

Markdown 使用 # 符号定义标题，# 的数量表示标题的层级（1 到 6 级，类似于 HTML 的 <h1> 到 <h6>）。

语法：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

渲染效果：

• # 一级标题 → 大号标题（相当于 <h1>）
• ## 二级标题 → 稍小号标题（相当于 <h2>）
• 以此类推。

注意：

• # 后需加一个空格。
• 标题常用于文档结构化，清晰划分内容层次。

替代语法（仅限一级和二级标题）：

一级标题
========

二级标题
--------

这种方式较少使用，但仍被支持。

---

2.2 段落和换行（Paragraphs and Line Breaks）

Markdown 的段落由一行或多行文本组成，段落之间用空行分隔。

语法：

这是一个段落。可以在一行内写很多内容，换行不会影响渲染。

这是另一个段落。

渲染效果：

• 每个段落会被渲染为 HTML 的 <p> 标签。
• 段内换行（按 Enter）不会产生新段落，除非有空行。

换行：
在行尾添加两个或更多空格并按 Enter，可以强制换行（不产生新段落）。

语法：

第一行  （两个空格）
第二行

渲染效果：

第一行
第二行

---

2.3 强调（Emphasis）

Markdown 支持文本的加粗和斜体，用于强调内容。

语法：

• 斜体：用单个 * 或 _ 包裹文本。
• 加粗：用两个 * 或 _ 包裹文本。
• 加粗斜体：用三个 * 或 _ 包裹文本。

*斜体* 或 _斜体_
**加粗** 或 __加粗__
***加粗斜体*** 或 ___加粗斜体___

渲染效果：

• 斜体（<em>）
• 加粗（<strong>）
• 加粗斜体（<strong><em>）

注意：

• 不要在 * 或 _ 与文本之间加空格，否则无效。
• 尽量保持 * 和 _ 风格一致（例如，全程用 *）。

---

2.4 列表（Lists）

Markdown 支持有序列表和无序列表，类似于 HTML 的 <ol> 和 <ul>。

无序列表（Unordered Lists）

使用 *、- 或 + 作为列表项的标记。

语法：