markdown标记语言及其语法介绍

以下是关于 Markdown格式介绍及其语法详细教程 的综合整理，结合了多个权威来源的语法规则和示例。

一、Markdown简介

Markdown是一种轻量级标记语言，由 John Gruber 和 Aaron Swartz 于2004年设计，旨在通过简单的纯文本语法实现结构化文档的编写，并支持转换为HTML、PDF等格式。如今已成为世界上最受欢迎的标记语言之一。

使用 Markdown 与使用 Word 类编辑器不同。在 Word 之类的应用程序中，单击按钮以设置单词和短语的格式，并且，更改立即可见。而 Markdown 与此不同，当你创建 Markdown 格式的文件时，可以在文本中添加 Markdown 语法，以指示哪些单词和短语看起来应该有所不同。

核心特点：

• 简洁性：仅需少量符号（如#、*、-）即可完成排版。
• 可读性：未渲染的文本仍清晰易读。
• 兼容性：支持GitHub、博客平台、笔记工具等场景。

为什么要使用 Markdown？

当你可以通过按下界面中的按钮来设置文本格式时，为什么还要使用 Markdown 来书写呢？使用 Markdown 而不是 word 类编辑器的原因有：

• Markdown 无处不在。StackOverflow、CSDN、掘金、简书、GitBook、有道云笔记、V2EX、光谷社区等。主流的代码托管平台，如 GitHub、GitLab、BitBucket、Coding、Gitee 等等，都支持 Markdown 语法，很多开源项目的 README、开发文档、帮助文档、Wiki 等都用 Markdown 写作。
• Markdown 是纯文本可移植的。几乎可以使用任何应用程序打开包含 Markdown 格式的文本文件。如果你不喜欢当前使用的 Markdown 应用程序了，则可以将 Markdown 文件导入另一个 Markdown 应用程序中。这与 Microsoft Word 等文字处理应用程序形成了鲜明的对比，Microsoft Word 将你的内容锁定在专有文件格式中。
• Markdown 是独立于平台的。你可以在运行任何操作系统的任何设备上创建 Markdown 格式的文本。
• Markdown 能适应未来的变化。即使你正在使用的应用程序将来会在某个时候不能使用了，你仍然可以使用文本编辑器读取 Markdown 格式的文本。当涉及需要无限期保存的书籍、大学论文和其他里程碑式的文件时，这是一个重要的考虑因素。

可以使用在线 Markdown 编辑器(opens new window)来编写 Markdown。进入其站点就可以开始在左侧窗格中书写了。渲染后的文档在右侧窗格预览。

Markdown 的工作原理

在使用 Markdown 格式书写时，文本内容存储在带有 .md 或 .markdown 扩展名的纯文本文件中。那然后呢？你的 Markdown 格式的文件如何转换为 HTML 或可打印的文档呢？

简单来说，你需要一个能够处理 Markdown 文件的 Markdown 应用程序。有许多应用程序可供选择，从简单的脚本到类似于 Microsoft Word 的桌面应用程序。尽管它们在视觉上有所不同，但所有应用程序都执行相同的操作。像 在线 Markdown 编辑器 (opens new window)一样，它们都是将 Markdown 格式的文本转换为 HTML，以便可以在 Web 浏览器中显示。

Markdown 应用程序使用一种称为 Markdown 处理器（也通常称为“解析器”或“实现”）的东西将获取到的 Markdown 格式的文本输出为 HTML 格式。此时，可以在 Web 浏览器中查看你的文档，或者将其与样式表组合并打印。你可以在下图看到此过程的直观表示。

Markdown 有什么用？

Markdown 是做笔记、为网站创建内容以及生成可打印文档的快速、简便的方法。

学习 Markdown 语法并不需要很长时间，一旦你知道如何使用它，你就可以在几乎所有地方使用 Markdown 进行书写了。大多数人使用 Markdown 来为网站创建内容，但是 Markdown 也可以很好地格式化从电子邮件到购物清单的所有内容。

二、基础语法详解

1. 标题

使用 # 的数量表示标题级别（1-6级）：

# 一级标题  
## 二级标题  
### 三级标题  

注意：标题后需空格。

2. 文本样式

• 加粗：**文本** 或 __文本__
• 斜体：*文本* 或 _文本_
• 粗斜体：***文本*** 或 ___文本___
• 删除线：~~文本~~。

3. 列表

• 无序列表：用 -、* 或 + - 项目1 * 项目2
• 有序列表：数字加 . 1. 第一项 2. 第二项 嵌套列表：子项缩进2空格。

4. 链接与图片

• 链接：[显示文本](URL) [Google]( https://www.google.com )
• 图片：![描述](图片URL)  支持标题（悬停文本）：[链接](URL "标题")。

5. 代码

• 行内代码：`代码`
• 代码块：用三个反引号 ``` 包裹（可指定语言）： ```python print("Hello") ``` 支持语法高亮（如Python、Java）。

6. 引用

用 > 表示引用，可嵌套：

> 一级引用
>> 二级引用

7. 分割线

用 ***、--- 或 ___（至少3个符号）：

---

三、进阶语法

1. 表格

用 | 和 - 对齐：

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 数据1  | 数据2 |  数据3 |

冒号 : 控制对齐方式。

2. 数学公式

需LaTeX语法（部分编辑器支持）：

• 行内公式：$E=mc^2$
• 独立公式： $$ \sum_{i=1}^n i = \frac{n(n+1)}{2} $$

3. 任务列表

用 - [ ] 或 - [x]：

- [ ] 未完成
- [x] 已完成

4. 脚注与注释

正文[1](@ref)  
[1](@ref): 脚注内容

四、工具与扩展

• 编辑器推荐：Typora（实时预览）、VS Code（插件支持）。
• 在线工具：Dillinger（实时转换）、Markdown Here（浏览器插件）。
• 扩展功能：流程图（Mermaid）、图表（PlantUML）。

五、常见问题

1. 换行问题：段落间需空一行，行末加2空格强制换行。
2. 转义字符：用 \ 避免符号冲突（如 \* 显示为*）。
3. 兼容性差异：不同平台对表格、公式的支持可能不同。

通过掌握上述语法，可高效编写结构清晰、易于维护的文档。如需更高级功能（如自定义CSS），可结合HTML标签扩展。