Markdown 完整使用指南
介绍
Markdown 是一种轻量级标记语言，旨在以易读易写的纯文本格式编写结构化文档。它广泛应用于博客撰写、文档编写、GitHub README、技术笔记等场景。
Markdown 基础语法
1. 标题（Headings）
使用 # 表示标题，最多支持六级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
2. 强调（Emphasis）
- 加粗：
**加粗文本**或__加粗文本__ - 斜体：
*斜体文本*或_斜体文本_ 删除线：~~删除线文本~~
3. 列表（Lists）
- 无序列表：使用
-、+或*
- 项目一
- 项目二
- 项目三
- 有序列表：使用数字加点
1. 第一项
2. 第二项
3. 第三项
4. 链接与图片（Links & Images）
- 链接：
[链接文本](URL) - 图片：
5. 代码（Code）
- 行内代码：使用单个反引号
- 代码块：使用三个反引号
6. 引用（Blockquotes）
使用 > 表示引用。
> 这是一个引用块。
7. 水平线（Horizontal Rule）
使用三个或更多的 -、* 或 _。
---
扩展语法与进阶功能
1. 表格（Tables）
基本格式
表格的基本语法是使用管道符号（|）和短横线（-）来定义。每列之间使用 | 进行分隔，表头和表体之间使用 - 来表示分隔行。
语法格式：
| 列名1 | 列名2 | 列名3 |
|-------|-------|-------|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |渲染效果：
| 列名1 | 列名2 | 列名3 |
|---|---|---|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
对齐方式
在表格中，我们可以通过设置分隔行中的短横线（-）两侧的冒号（:）来控制文本的对齐方式。常见的对齐方式有 左对齐、居中对齐 和 右对齐，默认为左对齐。
- 左对齐：
:--- - 居中对齐：
:---: - 右对齐：
---:
语法格式：
| 左对齐 | 居中对齐 | 右对齐 |
|:------|:-------:|-------:|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
渲染效果：
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
2. 脚注（Footnotes）
脚注的基本语法是在文本中插入一个带有 [^脚注标识] 的引用，并在文档的其他地方用 [^脚注标识]: 脚注内容 来定义脚注的内容。
这是一个脚注[^1]。[^1]: 这是脚注的内容。
渲染效果：
这是一个带有脚注的句子1。
3. 任务列表（Task Lists）
任务列表（Task Lists）是一种在 Markdown 中常用的功能，通常用于显示待办事项、进度跟踪等。在 Markdown 中，创建任务列表的语法非常简单。你只需要在每个任务项前面添加一个方括号（[] 或 [x]），然后再跟上任务内容。
- [ ] 待办事项
- [x] 已完成事项
渲染效果：
- 待办事项
- 已完成事项
4. 自定义 ID（Custom IDs）
最常见的用法是在标题元素中为特定标题添加自定义 ID，以便在文档的其他地方引用。通常，你可以通过添加 {#id} 来为 Markdown 标题设置自定义 ID。
## 安装教程 {#installation}这里是安装教程的内容。## 使用指南 {#usage}这里是使用指南的内容。
你可以在文档中的其他地方创建一个跳转链接：
[点击这里查看安装教程](#installation)
[点击这里查看使用指南](#usage)
5. 公式
在 Markdown 中，公式（尤其是数学公式）通常是通过 LaTeX 语法来表示的，许多 Markdown 渲染器（如 GitHub、Jupyter Notebooks、Typora 等）都支持使用 LaTeX 语法插入数学公式。
在 Markdown 中，你可以使用 $...$ 和 $$...$$ 来嵌入数学公式。
- 行内公式：使用单个
$来嵌入数学公式，公式会嵌入到文本行中。 - 块级公式：使用双
$$来创建块级数学公式，公式会在单独的行中显示。
1. 行内公式
行内公式是将公式嵌入到普通文本中，公式会与文字在同一行显示。
语法格式：
这是一个行内公式 $E = mc^2$。
渲染效果：
这是一个行内公式 E=mc2E = mc^2E=mc2。
2. 块级公式
块级公式是将公式单独放在一行中，并通常居中显示。常用于表示复杂的公式或大型公式。
语法格式：
$$
E = mc^2
$$
渲染效果：
E=mc2E = mc^2 E=mc2
3. 常用的 LaTeX 数学符号
✨基本运算符
- 加法：
+ - 减法：
- - 乘法：
\times或* - 除法：
\div或/ - 等号：
=
- 加法: $a + b$
- 乘法: $a \times b$
渲染效果：
- 加法: a+ba + ba+b
- 乘法: a×ba \times ba×b
✨指数和根号
- 指数：
a^b - 平方根：
\sqrt{a}
- 指数: $a^b$
- 平方根: $\sqrt{a}$
渲染效果：
- 指数: aba^bab
- 平方根: a\sqrt{a}a
✨分数
使用 \frac{numerator}{denominator} 来表示分数。
- 分数: $\frac{a}{b}$
渲染效果：
- 分数: ab\frac{a}{b}ba
✨希腊字母
LaTeX 允许你使用希腊字母，如 \alpha, \beta, \gamma, 等等。
- 希腊字母: $\alpha, \beta, \gamma$
渲染效果：
- 希腊字母: α,β,γ\alpha, \beta, \gammaα,β,γ
✨求和符号与积分符号
- 求和：
\sum_{i=1}^{n} - 积分：
\int_{a}^{b}
- 求和: $\sum_{i=1}^{n} i$
- 积分: $\int_{0}^{1} x^2 \, dx$
渲染效果：
- 求和: ∑i=1ni\sum_{i=1}^{n} i∑i=1ni
- 积分: ∫01x2dx\int_{0}^{1} x^2 \, dx∫01x2dx
平台差异与兼容性
不同平台可能对 Markdown 的支持程度不同，以下是一些常见平台的差异：
- GitHub Flavored Markdown (GFM)：在 CommonMark 基础上进行了扩展，支持任务列表、表格等。
- GitLab：与 GFM 类似，但在某些语法上有所不同。
- Reddit：使用自定义的 Markdown 变体，支持嵌套列表、代码块等。
建议在使用 Markdown 时，参考各平台的官方文档，确保语法的兼容性。
实用工具与资源
- CommonMark 官方规范：提供详细的语法规范和示例。
- Markdown Paste：在线 Markdown 编辑器，支持实时预览和导出。
- Daring Fireball：John Gruber 的原始 Markdown 规范。
- GitHub Flavored Markdown Spec：GitHub 的 Markdown 扩展规范。
这是脚注的详细说明。 ↩︎