其他 – Wu's Blog

Markdown 语法详解

Wu — Fri, 02 Jan 2026 12:11:45 +0000

什么是 Markdown 语法

Markdown 语法是一种轻量级标记语言的格式化规则集合，由 John Gruber 在 2004 年创建[1]。它使用简单的文本符号来表示格式化元素，如标题、粗体、斜体、链接和列表等。Markdown 的核心理念是让文档在纯文本状态下就具有良好的可读性，同时能够轻松转换为 HTML 或其他格式。

Markdown 语法的设计哲学体现在其创始人 John Gruber 的原始描述中：”Markdown 的语法完全由标点符号组成，这些标点符号经过精心选择，看起来就像它们所表示的意思”[2]。这种直观性使得 Markdown 成为了技术写作、文档编写和内容创作的首选工具。

与传统的富文本编辑器不同，Markdown 采用纯文本格式，这意味着您可以使用任何文本编辑器来编写 Markdown 文档。这种简洁性带来了诸多优势：文件体积小、版本控制友好、跨平台兼容性强，以及学习成本低。无论您是程序员、技术写作者、博客作者还是学生，掌握 Markdown 语法都能显著提升您的文档编写效率。

Markdown 语法的标准化经历了多个阶段的发展。最初的 Markdown 规范相对简单，但随着使用场景的扩展，出现了许多变体和扩展。CommonMark 项目致力于创建一个明确、无歧义的 Markdown 规范[3]，而 GitHub Flavored Markdown (GFM) 则在标准 Markdown 基础上增加了表格、任务列表等实用功能[4]。

为什么要掌握 Markdown 语法

掌握 Markdown 语法在当今的数字化工作环境中具有重要意义。首先，Markdown 已经成为技术文档的事实标准。GitHub、GitLab、Stack Overflow、Reddit 等主流平台都支持 Markdown 格式，这意味着熟练使用 Markdown 语法能够让您在这些平台上更有效地交流和协作。

从效率角度来看，Markdown 语法能够显著提升写作速度。传统的富文本编辑器需要频繁使用鼠标进行格式化操作，而 Markdown 允许您在不离开键盘的情况下完成所有格式化工作。研究表明，熟练的 Markdown 用户的写作速度比使用传统编辑器的用户快 30-50%[5]。

Markdown 语法的另一个重要优势是其出色的可移植性。由于 Markdown 文档是纯文本格式，它们可以在任何设备、任何操作系统上打开和编辑。您不必担心软件兼容性问题，也不会遇到格式丢失的困扰。这种特性使得 Markdown 成为长期文档存储的理想选择。

在版本控制方面，Markdown 语法展现出了独特的优势。Git 等版本控制系统能够精确跟踪 Markdown 文档的变化，显示具体的文本修改内容。这对于团队协作和文档维护来说是极其宝贵的功能。相比之下，二进制格式的文档（如 Word 文档）在版本控制中只能显示文件已更改，无法展示具体的修改内容。

从学习投资回报率的角度来看，Markdown 语法具有学习成本低、应用范围广的特点。基础语法可以在几小时内掌握，而这些知识可以在多个平台和场景中重复使用。无论是编写技术文档、撰写博客文章、制作演示文稿，还是记录会议纪要，Markdown 都能提供一致的写作体验。

基础语法核心

基础语法是 Markdown 的核心组成部分，这些语法元素在几乎所有 Markdown 解析器中都得到支持。掌握这些基础语法能够满足大部分日常写作需求，是学习 Markdown 的重要基础。

标题语法

标题是文档结构的骨架，Markdown 提供了两种创建标题的方法。主要方法是使用井号（#）符号，这种方法支持六个级别的标题，对应 HTML 中的 h1 到 h6 标签。

井号标题语法

井号标题语法是最常用和推荐的标题创建方法。语法规则非常简单：在文本前添加一个或多个井号，井号的数量决定标题的级别。需要注意的是，井号和标题文本之间必须有一个空格，这是为了确保在不同 Markdown 解析器中的兼容性[6]。

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

在实际使用中，标题的层次结构应该保持逻辑性和一致性。一级标题通常用于文档标题，二级标题用于主要章节，三级标题用于子章节，以此类推。避免跳级使用标题，例如从一级标题直接跳到三级标题，这会影响文档的可读性和 SEO 效果。

替代标题语法

Markdown 还支持另一种标题语法，称为 Setext 风格，但仅支持一级和二级标题。这种语法在标题文本下方添加等号（=）或连字符（-）来表示标题级别。

# 一级标题

## 二级标题

虽然这种语法在视觉上更加突出，但由于只支持两个级别且不如井号语法简洁，在实际使用中较少采用。大多数现代 Markdown 编辑器和解析器都更好地支持井号语法。

标题最佳实践

在使用标题语法时，有几个重要的最佳实践需要遵循。首先，始终在井号和标题文本之间添加空格，这确保了跨平台的兼容性。其次，在标题前后添加空行，这有助于提高文档的可读性，特别是在纯文本状态下查看时。

这是一段普通文本。

# 这是正确的标题格式

这是标题后的内容。

另一个重要的实践是保持标题的层次结构清晰。每个文档应该只有一个一级标题，通常作为文档的主标题。二级标题用于主要章节，三级标题用于子章节，依此类推。这种结构不仅有助于读者理解文档内容，也有利于搜索引擎优化和自动生成目录。

文本格式化

文本格式化是 Markdown 中最常用的功能之一，包括粗体、斜体、删除线等基本格式。这些格式化选项使用简单的符号来实现，既直观又易于记忆。

粗体文本

粗体文本用于强调重要内容，在 Markdown 中有两种创建粗体的方法：使用双星号（**）或双下划线（__）。两种方法在功能上完全相同，但推荐使用双星号，因为它在各种 Markdown 解析器中的兼容性更好。

**这是粗体文本**
**这也是粗体文本**

在单词中间添加粗体强调时，必须使用星号而不是下划线，因为下划线在单词中间可能不被正确解析[7]。

Love**is**bold # 正确
Love**is**bold # 可能不被正确解析

斜体文本

斜体文本用于表示强调或引用，使用单星号（*）或单下划线（_）创建。与粗体类似，推荐使用星号以确保更好的兼容性。

_这是斜体文本_
_这也是斜体文本_

粗体和斜体组合

当需要同时使用粗体和斜体时，可以组合使用三个星号或下划线。这种格式在技术文档中经常用于强调特别重要的概念或术语。

**_这是粗体斜体文本_**
**_这也是粗体斜体文本_**
**_混合使用也可以_**
_**这样也行**_

删除线

删除线用于表示已删除或不再有效的内容，使用双波浪号（~~）创建。这个功能在 GitHub Flavored Markdown 中得到广泛支持，但在标准 Markdown 中可能不被支持。

~~这是删除线文本~~

下划线

标准 Markdown 不直接支持下划线格式，但可以使用 HTML 标签来实现：

这是下划线文本

文本格式化最佳实践

在使用文本格式化时，应该遵循一些重要的原则。首先，格式化应该有明确的目的，避免过度使用。粗体用于强调重要概念，斜体用于引用或轻微强调，删除线用于表示修订内容。

其次，保持格式化的一致性。在同一文档中，应该使用相同的符号来创建相同的格式。例如，如果选择使用星号创建粗体，就应该在整个文档中都使用星号，而不是混合使用星号和下划线。

最后，注意格式化符号周围的空格。格式化符号应该紧贴被格式化的文本，不应该有额外的空格。

**正确的粗体**
** 错误的粗体 **

段落和换行

段落和换行的处理是 Markdown 中一个容易被误解的概念。理解这些规则对于创建格式良好的文档至关重要。

段落创建

在 Markdown 中，段落是由一个或多个连续的文本行组成，段落之间用一个或多个空行分隔。这个规则看似简单，但在实际使用中经常被忽视，导致文档格式不符合预期。

这是第一个段落。这个段落包含多个句子，它们会被渲染在同一个段落中。

这是第二个段落。注意上面有一个空行将两个段落分开。

重要的是要理解，仅仅按回车键并不会创建新段落。如果两行文本之间没有空行，它们会被合并为同一个段落。

这是第一行
这是第二行

# 上面两行会被合并为一个段落

这是第三行

这是第四行

# 上面两行是两个独立的段落

换行创建

有时候我们需要在段落内创建换行，而不是新段落。Markdown 提供了几种方法来实现这一点，但最可靠的方法是在行末添加两个或更多空格，然后按回车键。

这是第一行  
这是第二行，注意上一行末尾有两个空格

另一种方法是使用 HTML 的标签：

这是第一行

这是第二行

段落格式化最佳实践

在处理段落和换行时，有几个重要的最佳实践。首先，不要在段落开头添加空格或制表符来缩进，这可能导致意外的格式化效果，特别是在代码块的处理上。

其次，使用空行来分隔段落，这不仅符合 Markdown 规范，也提高了纯文本状态下的可读性。即使在 Markdown 编辑器中，清晰的段落分隔也有助于内容的组织和编辑。

对于换行，虽然行末双空格是标准方法，但由于空格在编辑器中不可见，容易被意外删除。在需要精确控制换行的场景中，使用 HTML 标签可能是更可靠的选择。

列表语法

列表是组织信息的重要工具，Markdown 支持有序列表和无序列表两种类型。列表语法简单直观，但在嵌套和复杂结构的处理上需要注意一些细节。

无序列表

无序列表使用星号（*）、加号（+）或连字符（-）作为列表标记。三种标记在功能上完全相同，但为了保持一致性，建议在同一文档中使用相同的标记。

- 第一项
- 第二项
- 第三项

* 第一项
* 第二项
* 第三项

- 第一项
- 第二项
- 第三项

列表标记后必须跟一个空格，然后是列表项的内容。这个空格是必需的，没有空格的话，文本不会被识别为列表项。

嵌套列表

列表可以嵌套，创建多层次的结构。嵌套通过缩进来实现，子列表项需要在父列表项下缩进四个空格或一个制表符。

1. 第一项
   - 子项 1
   - 子项 2
2. 第二项
   1. 有序子项 1
   2. 有序子项 2
3. 第三项

在嵌套列表中，可以混合使用有序和无序列表。缩进必须保持一致，否则可能导致列表结构混乱。

列表中的其他元素

列表项可以包含多个段落、代码块、引用等其他 Markdown 元素。关键是保持正确的缩进，确保这些元素被识别为列表项的一部分。

1. 第一项

   这是第一项的第二段落。注意缩进。

2. 第二项

   > 这是第二项中的引用块。

这是第二项中的代码块

3. 第三项

列表最佳实践

使用列表时，应该注意几个重要的实践原则。首先，保持列表标记的一致性。在同一个列表中，使用相同的标记符号。其次，注意缩进的准确性，特别是在嵌套列表和包含多个元素的列表项中。

对于长列表，考虑使用有序列表，即使顺序不重要，因为有序列表在引用特定项目时更加方便。在列表项较长时，可以考虑在列表项之间添加空行来提高可读性。

链接语法

链接是连接网络内容的重要元素，Markdown 提供了多种创建链接的方法。掌握这些方法能够让您创建更加丰富和互联的文档。

内联链接

内联链接是最常用的链接格式，语法为 [链接文本](URL "可选标题")。链接文本是显示给读者的文字，URL 是链接的目标地址，可选标题会在鼠标悬停时显示。

[ToMarkdown.org](https://tomarkdown.org/zh "最好的 Markdown 转换工具")
[GitHub](https://github.com)
[联系我们](mailto:contact@example.com)

内联链接的优势是所有信息都在一处，易于阅读和维护。但在链接较多的文档中，可能会影响文本的可读性。

引用式链接

引用式链接将链接定义与链接使用分离，提高了文档的可读性。这种方法特别适用于包含大量链接的长文档。

这是一个指向 [ToMarkdown.org][1] 的链接。
这是另一个指向 [GitHub] GitHub

			
				
					/
				
				
			
		

				
					 
				
				
					 
				
			
 的链接。

[1]: https://tomarkdown.org "Markdown 转换工具"
 GitHub

			
				
					/
				
				
			
		

				
					 
				
				
					 
				
			
: https://github.com "代码托管平台"

引用式链接的标识符可以是数字、字母或单词，不区分大小写。链接定义可以放在文档的任何位置，但通常放在段落末尾或文档末尾。

自动链接

对于简单的 URL 或邮箱地址，Markdown 支持自动链接功能。将 URL 或邮箱地址用尖括号包围，就会自动创建链接。

许多现代 Markdown 解析器还支持不使用尖括号的自动链接识别，但为了确保兼容性，建议使用尖括号。

内部链接

在长文档中，经常需要创建指向文档内部章节的链接。Markdown 支持使用标题作为锚点的内部链接。

[跳转到基础语法](#基础语法核心)
[查看常见问题](#常见问题解答)

标题锚点的生成规则是：将标题转换为小写，空格替换为连字符，移除特殊字符。不同的 Markdown 解析器可能有略微不同的规则，建议在使用前进行测试。

链接最佳实践

创建链接时，应该遵循一些重要的最佳实践。首先，链接文本应该具有描述性，避免使用”点击这里”或”更多信息”等通用文本。好的链接文本应该让读者知道点击后会看到什么内容。

# 好的链接文本

[Markdown 官方语法文档](https://daringfireball.net/projects/markdown/syntax)

# 不好的链接文本

[点击这里](https://daringfireball.net/projects/markdown/syntax) 查看 Markdown 语法

其次，对于外部链接，考虑添加标题属性来提供额外信息。这不仅改善了用户体验，也有助于搜索引擎优化。

最后，在使用引用式链接时，保持引用标识符的一致性和可读性。使用有意义的标识符而不是随机数字，这有助于文档的维护。

图片语法

图片是现代文档中不可或缺的元素，Markdown 的图片语法与链接语法非常相似，只是在前面添加了感叹号。

内联图片

内联图片的语法为 ![替代文本](image-url "可选标题")。替代文本在图片无法显示时显示，也用于屏幕阅读器的无障碍访问。

![Markdown Logo](https://markdown-here.com/img/icon256.png "Markdown 标志")
![本地图片](markdown_syntax_hero.png)

替代文本虽然是可选的，但强烈建议提供，这不仅有助于无障碍访问，也有利于搜索引擎优化。

引用式图片

与链接类似，图片也支持引用式语法，这在需要多次使用同一图片或管理大量图片时特别有用。

![Markdown Logo][logo]
![另一个图片][pic2]

[logo]: https://markdown-here.com/img/icon256.png "Markdown 标志"
[pic2]: markdown_syntax_comparison.png "示例图片"

图片尺寸控制

标准 Markdown 不支持直接控制图片尺寸，但可以使用 HTML 标签来实现：

图片最佳实践

使用图片时，有几个重要的最佳实践需要遵循。首先，始终提供有意义的替代文本，描述图片的内容和作用。这对于视觉障碍用户和搜索引擎都很重要。

其次，考虑图片的文件大小和加载速度。在网络文档中，过大的图片会影响页面加载速度。建议对图片进行适当的压缩和优化。

最后，使用相对路径来引用本地图片，这使得文档更容易移植和分享。同时，确保图片文件与 Markdown 文档一起管理，避免链接失效。

代码语法

代码语法是 Markdown 中最重要的功能之一，特别是在技术文档中。Markdown 提供了内联代码和代码块两种方式来显示代码。

内联代码

内联代码用于在段落中插入简短的代码片段，使用反引号（`）包围代码文本。

使用 `console.log()` 函数来输出信息。
在 HTML 中，`` 是一个常用的容器元素。

如果代码本身包含反引号，可以使用多个反引号来包围：

`` 这里有一个反引号 ` 在代码中 ``

代码块

代码块用于显示多行代码，有两种创建方法：缩进式和围栏式。

缩进式代码块

通过在每行前添加四个空格或一个制表符来创建代码块：

    function hello() {
        console.log("Hello, World!");
    }

围栏式代码块

使用三个反引号（“`）或三个波浪号（~~~）来包围代码块，这种方法更加灵活和常用：

```
function hello() {
    console.log("Hello, World!");
}
```

语法高亮

围栏式代码块支持语法高亮，只需在开始的三个反引号后指定编程语言：

```javascript
function hello() {
  console.log("Hello, World!");
}
```

```python
def hello():
    print("Hello, World!")
```

```css
.container {
  max-width: 1200px;
  margin: 0 auto;
}
```

代码最佳实践

使用代码语法时，应该遵循一些重要的实践原则。首先，为代码块指定正确的编程语言，这不仅启用语法高亮，也有助于代码的理解和维护。

其次，保持代码的格式化和缩进一致。虽然 Markdown 会保留代码块中的格式，但良好的代码格式有助于阅读和理解。

对于长代码块，考虑添加注释来解释关键部分。在技术文档中，代码的可理解性与正确性同样重要。

最后，在内联代码中，避免使用过长的代码片段。如果代码超过几个单词，考虑使用代码块来显示。

引用语法

引用语法用于标识引用的文本、重要的说明或者创建视觉上的层次结构。Markdown 的引用语法简单而强大，支持多层嵌套和复杂结构。

基本引用

使用大于号（>）在行首创建引用块。引用块可以包含任何其他 Markdown 元素，包括标题、列表、代码块等。

> 这是一个引用块。
> 它可以包含多行文本。
>
> 引用块中也可以有段落。

嵌套引用

引用块可以嵌套，通过使用多个大于号来实现不同的嵌套级别：

> 这是第一级引用。
>
> > 这是第二级引用。
> >
> > > 这是第三级引用。
>
> 回到第一级引用。

引用中的其他元素

引用块可以包含其他 Markdown 元素，如标题、列表、代码块等：

> ## 引用中的标题
>
> 1. 引用中的列表项
> 2. 另一个列表项
>
> ```
> 引用中的代码块
> ```
>
> 这是引用中的普通段落。

引用最佳实践

使用引用语法时，应该注意几个重要的实践原则。首先，引用应该有明确的目的，如标识引用的文本、重要的警告信息或者创建视觉层次。

其次，在长引用中，保持适当的段落分隔和格式化。这有助于提高引用内容的可读性。

最后，避免过度嵌套引用。虽然 Markdown 支持多层嵌套，但过深的嵌套会影响可读性。一般建议不超过三层嵌套。

分隔线

分隔线用于在文档中创建视觉分隔，标识不同章节或主题的转换。Markdown 提供了三种创建分隔线的方法。

分隔线语法

可以使用三个或更多的连字符（-）、星号（*）或下划线（_）来创建分隔线：

---
---

---

这三种方法产生相同的效果，选择哪种主要是个人偏好问题。为了保持一致性，建议在同一文档中使用相同的符号。

分隔线最佳实践

使用分隔线时，应该注意几个重要的原则。首先，分隔线前后应该有空行，这确保了分隔线被正确识别，也提高了文档的可读性。

其次，不要过度使用分隔线。分隔线应该用于标识重要的内容转换，而不是简单的装饰。过多的分隔线会分散读者的注意力。

最后，考虑使用标题来代替分隔线进行内容组织。在大多数情况下，适当的标题结构比分隔线更有效地组织内容。

转义字符

在 Markdown 中，某些字符具有特殊含义，如星号用于创建粗体或斜体。当需要显示这些字符的字面意思时，需要使用转义字符。

需要转义的字符

以下字符在 Markdown 中具有特殊含义，可能需要转义：

\ 反斜杠
` 反引号

- 星号
  \_ 下划线
  {} 大括号
  [] 方括号
  () 圆括号

# 井号

- 加号

* 连字符
  . 点号
  ! 感叹号

转义方法

使用反斜杠（\）来转义特殊字符：

\*这不是斜体文本\*
\#这不是标题
\[这不是链接\]

转义最佳实践

在使用转义字符时，应该注意几个重要的原则。首先，只在必要时使用转义。如果字符在当前上下文中不会被误解为 Markdown 语法，通常不需要转义。

其次，在代码块和内联代码中，大多数字符不需要转义，因为它们会被按字面意思处理。

最后，了解不同 Markdown 解析器的差异。某些解析器可能对转义字符的处理略有不同，在跨平台使用时需要注意这些差异。

扩展语法进阶

扩展语法是在基础 Markdown 语法之上添加的功能，这些功能在不同的 Markdown 解析器中可能有不同的支持程度。了解这些扩展语法能够让您创建更加丰富和功能强大的文档。

表格语法

表格是组织数据的重要工具，虽然不在原始 Markdown 规范中，但现在几乎所有现代 Markdown 解析器都支持表格语法。

基础表格

表格使用管道符（|）来分隔列，第二行使用连字符（-）来定义表头：

| 姓名 | 年龄 | 职业     |
| ---- | ---- | -------- |
| 张三 | 25   | 工程师   |
| 李四 | 30   | 设计师   |
| 王五 | 28   | 产品经理 |

表格对齐

可以在分隔行中使用冒号（:）来控制列的对齐方式：

| 左对齐   | 居中对齐 |   右对齐 |
| :------- | :------: | -------: |
| 内容     |   内容   |     内容 |
| 更多内容 | 更多内容 | 更多内容 |

:------- 左对齐（默认）
:------: 居中对齐
-------: 右对齐

表格最佳实践

创建表格时，应该注意几个重要的实践原则。首先，保持表格的简洁性。过于复杂的表格在移动设备上可能难以阅读，考虑将复杂表格拆分为多个简单表格。

其次，为表格提供清晰的表头。表头应该准确描述列的内容，有助于读者理解数据。

最后，在表格较大时，考虑使用对齐来提高可读性。数字通常右对齐，文本左对齐，标题居中对齐。

任务列表

任务列表是 GitHub Flavored Markdown 引入的功能，现在被广泛支持。它们特别适用于项目管理和待办事项跟踪。

- [x] 完成的任务
- [ ] 未完成的任务
- [x] 另一个完成的任务
- [ ] 待办事项
  - [ ] 子任务 1
  - [x] 子任务 2

任务列表可以嵌套，也可以与其他列表元素混合使用。在支持交互的平台上，用户可以直接点击复选框来切换任务状态。

脚注

脚注允许您在文档中添加额外的解释或引用，而不会打断主要内容的流畅性。

这是一个包含脚注的句子[^1]。

这是另一个脚注[^note]。

[^1]: 这是第一个脚注的内容。
[^note]: 这是命名脚注的内容，可以包含多个段落。

    脚注可以包含多个段落，只需要保持适当的缩进。

定义列表

定义列表用于创建术语和定义的配对，在技术文档中特别有用：

术语 1
: 定义 1

术语 2
: 定义 2a
: 定义 2b

数学公式

许多 Markdown 解析器支持 LaTeX 风格的数学公式，使用美元符号（$）来标识：

内联公式：$E = mc^2$

块级公式：

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

高亮文本

某些 Markdown 解析器支持高亮文本，使用双等号（==）：

==这是高亮文本==

下标和上标

下标和上标在科学文档中经常使用：

H~2~O（下标）
X^2^（上标）

高级技巧和最佳实践

掌握基础语法后，了解一些高级技巧和最佳实践能够让您更高效地使用 Markdown，创建更专业的文档。

HTML 混合使用

Markdown 允许在文档中直接使用 HTML 标签，这为复杂格式化提供了灵活性。

常用 HTML 标签


  



点击展开

这里是隐藏的内容。


Ctrl + C

高亮文本

HTML 使用最佳实践

在使用 HTML 时，应该遵循几个重要原则。首先，只在 Markdown 无法实现所需格式时使用 HTML。过度使用 HTML 会降低文档的可读性和可移植性。

其次，确保 HTML 标签正确闭合，避免影响文档的其他部分。

最后，考虑兼容性。某些 Markdown 解析器可能不支持所有 HTML 标签，在跨平台使用时需要测试。

文档结构最佳实践

标题层次

建立清晰的标题层次结构是创建专业文档的关键：

# 文档标题（H1）- 每个文档只有一个

## 主要章节（H2）

### 子章节（H3）

#### 小节（H4）

##### 子小节（H5）- 谨慎使用

###### 最小节（H6）- 很少使用

目录创建

对于长文档，创建目录能够显著改善用户体验：

## 目录

1. [介绍](#介绍)
2. [安装](#安装)
   - [系统要求](#系统要求)
   - [安装步骤](#安装步骤)
3. [使用指南](#使用指南)
4. [常见问题](#常见问题)

可读性优化

段落长度

保持适当的段落长度，一般建议每段不超过 3-4 句话。长段落在屏幕上难以阅读，特别是在移动设备上。

列表使用

合理使用列表来组织信息：

使用无序列表展示并列的项目
使用有序列表展示步骤或优先级
使用任务列表跟踪进度

协作和版本控制

Git 友好的格式

在使用 Git 进行版本控制时，遵循一些格式化原则能够改善协作体验：

每句话单独一行，便于跟踪修改
避免过长的行，建议每行不超过 80-100 字符
使用一致的缩进和格式

注释和元数据

在文档中添加适当的注释和元数据：



# 文档标题

性能和优化

图片优化

使用适当的图片格式（JPEG 用于照片，PNG 用于图标）
压缩图片以减少文件大小
使用相对路径引用本地图片

常见问题解答

Q: 为什么我的 Markdown 在不同平台上显示不同？

A: 不同的 Markdown 解析器可能对语法的解释略有不同，特别是在扩展语法方面。为了确保兼容性，建议：

使用标准 Markdown 语法作为基础
在使用扩展语法前确认目标平台的支持情况
在多个平台上测试文档的显示效果
使用 CommonMark 规范作为参考标准

Q: 如何在 Markdown 中创建复杂的表格？

A: 标准 Markdown 表格功能有限，对于复杂表格，可以考虑以下方案：

将复杂表格拆分为多个简单表格
使用 HTML 表格标签获得更多控制
使用专门的表格生成工具
考虑使用图片来展示复杂的表格数据

Q: 如何在 Markdown 中添加视频？

A: 标准 Markdown 不直接支持视频嵌入，但可以使用以下方法：

使用 HTML 标签
嵌入 YouTube 或其他平台的 iframe 代码
使用视频的缩略图作为链接到视频的图片
某些平台支持特定的视频嵌入语法

Q: 如何处理 Markdown 中的特殊字符？

A: 当需要显示具有特殊含义的字符时：

使用反斜杠（\）进行转义
在代码块或内联代码中，大多数字符会被按字面意思处理
使用 HTML 实体编码（如 & 表示 &）
了解目标平台的特殊字符处理规则

Q: 如何优化 Markdown 文档的 SEO？

A: 虽然 Markdown 本身是纯文本，但可以通过以下方式优化 SEO：

使用清晰的标题层次结构
为图片提供有意义的替代文本
使用描述性的链接文本
在转换为 HTML 时添加适当的元数据
保持内容的高质量和相关性

语法速查表

基础语法快速参考

元素	Markdown 语法
标题	`# H1` `## H2` `### H3`
粗体	`粗体文本`
斜体	`斜体文本`
删除线	`~~删除文本~~`
内联代码	`代码`
代码块	`代码块`
链接	`[标题](https://www.example.com)`
图片	`![alt text](markdown_syntax_hero.png)`
无序列表	`- 项目`
有序列表	`1. 项目`
引用	`> 引用文本`
分隔线	`---`

扩展语法快速参考

元素	Markdown 语法
表格	`\| 标题 \| 标题 \|` `\|---\|---\|` `\| 内容 \| 内容 \|`
脚注	`文本[^1]` 和 `[^1]: 脚注内容`
任务列表	`- [x] 完成的任务` `- [ ] 未完成的任务`
高亮	`==高亮文本==`
下标	`H~2~O`
上标	`X^2^`

常用 HTML 标签

功能	HTML 语法
居中对齐	`内容`
图片尺寸
换行
键盘按键	`Ctrl`
高亮文本	`高亮`
折叠内容	`标题内容`

各种开源协议介绍

Wu — Fri, 02 Jan 2026 03:09:32 +0000

世界上的开源许可证（Open Source License）大概有上百种，今天我们来介绍下几种我们常见的开源协议。大致有GPL、BSD、MIT、Mozilla、Apache和LGPL等。

Apache License

Apache License（Apache许可证），是Apache软件基金会发布的一个自由软件许可证。

Apache Licence是著名的非盈利开源组织Apache采用的协议。该协议和BSD类似，同样鼓励代码共享和最终原作者的著作权，同样允许源代码修改和再发布。但是也需要遵循以下条件：

需要给代码的用户一份Apache Licence。
如果修改了代码，需要再被修改的文件中说明。
在衍生的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议，商标，专利声明和其他原来作者规定需要包含的说明。
如果再发布的产品中包含一个Notice文件，则在Notice文件中需要带有Apache Licence。你可以再Notice中增加自己的许可，但是不可以表现为对Apache Licence构成更改。
Apache Licence也是对商业应用友好的许可。使用者也可以再需要的时候修改代码来满足并作为开源或商业产品发布/销售。

使用这个协议的好处是:

永久权利一旦被授权，永久拥有。
全球范围的权利在一个国家获得授权，适用于所有国家。假如你在美国，许可是从印度授权的，也没有问题。
授权免费无版税，前期、后期均无任何费用。
授权无排他性任何人都可以获得授权
授权不可撤消一旦获得授权，没有任何人可以取消。比如，你基于该产品代码开发了衍生产品，你不用担心会在某一天被禁止使用该代码

BSD

BSD是”Berkeley Software Distribution”的缩写，意思是”伯克利软件发行版”。

BSD开源协议：是一个给于使用者很大自由的协议。可以自由的使用，修改源代码，也可以将修改后的代码作为开源或者专有软件再发布。当你发布使用了BSD协议的代码，或则以BSD协议代码为基础做二次开发自己的产品时，需要满足三个条件：

1．如果再发布的产品中包含源代码，则在源代码中必须带有原来代码中的BSD协议。
2．如果再发布的只是二进制类库/软件，则需要在类库/软件的文档和版权声明中包含原来代码中的BSD协议。
3．不可以用开源代码的作者/机构名字和原来产品的名字做市场推广。

BSD代码鼓励代码共享，但需要尊重代码作者的著作权。BSD由于允许使用者修改和重新发布代码，也允许使用或在BSD代码上开发商业软件发布和销售，因此是对商业集成很友好的协议。而很多的公司企业在选用开源产品的时候都首选BSD协议，因为可以完全控制这些第三方的代码，在必要的时候可以修改或者二次开发。

GPL

GPL （GNU General Public License）：GNU通用公共许可协议。

Linux 采用了 GPL。

GPL协议和BSD, Apache Licence等鼓励代码重用的许可很不一样。GPL的出发点是代码的开源/免费使用和引用/修改/衍生代码的开源/免费使用，但不允许修改后和衍生的代码做为闭源的商业软件发布和销售。这也就是为什么我们能用免费的各种linux，包括商业公司的linux和linux上各种各样的由个人，组织，以及商业软件公司开发的免费软件了。

LGPL

LGPL是GPL的一个为主要为类库使用设计的开源协议。和GPL要求任何使用/修改/衍生之GPL类库的的软件必须采用GPL协议不同。LGPL允许商业软件通过类库引用(link)方式使用LGPL类库而不需要开源商业软件的代码。这使得采用LGPL协议的开源代码可以被商业软件作为类库引用并发布和销售。

但是如果修改LGPL协议的代码或者衍生，则所有修改的代码，涉及修改部分的额外代码和衍生的代码都必须采用LGPL协议。因此LGPL协议的开源代码很适合作为第三方类库被商业软件引用，但不适合希望以LGPL协议代码为基础，通过修改和衍生的方式做二次开发的商业软件采用。

GPL/LGPL都保障原作者的知识产权，避免有人利用开源代码复制并开发类似的产品。

MIT

MIT是和BSD一样宽范的许可协议,源自麻省理工学院（Massachusetts Institute of Technology, MIT），又称X11协议。作者只想保留版权,而无任何其他了限制。MIT与BSD类似，但是比BSD协议更加宽松，是目前最少限制的协议。这个协议唯一的条件就是在修改后的代码或者发行包包含原作者的许可信息。适用商业软件。使用MIT的软件项目有：jquery、Node.js。

MIT与BSD类似，但是比BSD协议更加宽松，是目前最少限制的协议。这个协议唯一的条件就是在修改后的代码或者发行包包含原作者的许可信息。适用商业软件。使用MIT的软件项目有：jquery、Node.js。

MPL (Mozilla Public License 1.1)

MPL协议允许免费重发布、免费修改，但要求修改后的代码版权归软件的发起者。这种授权维护了商业软件的利益，它要求基于这种软件的修改无偿贡献版权给该软件。这样，围绕该软件的所有代码的版权都集中在发起开发人的手中。但MPL是允许修改，无偿使用得。MPL软件对链接没有要求。

EPL (Eclipse Public License 1.0)

EPL允许Recipients任意使用、复制、分发、传播、展示、修改以及改后闭源的二次商业发布。

使用EPL协议，需要遵守以下规则：

当一个Contributors将源码的整体或部分再次开源发布的时候,必须继续遵循EPL开源协议来发布,而不能改用其他协议发布.除非你得到了原”源码”Owner 的授权；
EPL协议下,你可以将源码不做任何修改来商业发布.但如果你要发布修改后的源码,或者当你再发布的是Object Code的时候,你必须声明它的Source Code是可以获取的,而且要告知获取方法；
当你需要将EPL下的源码作为一部分跟其他私有的源码混和着成为一个Project发布的时候,你可以将整个Project/Product以私人的协议发布,但要声明哪一部分代码是EPL下的,而且声明那部分代码继续遵循EPL；
4.独立的模块(Separate Module),不需要开源。

Creative Commons 知识共享协议

Creative Commons (CC) 许可协议并不能说是真正的开源协议，它们大多是被使用于设计类的工程上。 CC 协议种类繁多，每一种都授权特定的权利。一个 CC 许可协议具有四个基本部分，这几个部分可以单独起作用，也可以组合起来。下面是这几部分的简介：

1、署名作品上必须附有作品的归属。如此之后，作品可以被修改，分发，复制和其它用途。
2、相同方式共享作品可以被修改、分发或其它操作，但所有的衍生品都要置于CC许可协议下。
3、非商业用途作品可以被修改、分发等等，但不能用于商业目的。但语言上对什么是”商业”的说明十分含糊不清 (没有提供精确的定义)，所以你可以在你的工程里对其进行说明。例如，有些人简单的解释”非商业”为不能出售这个作品。而另外一些人认为你甚至不能在有广告的网站上使用它们。还有些人认为”商业”仅仅指你用它获取利益。
4、禁止衍生作品

CC 许可协议的这些条款可以自由组合使用。大多数的比较严格的CC协议会声明 “署名权，非商业用途，禁止衍生”条款，这意味着你可以自由的分享这个作品，但你不能改变它和对其收费，而且必须声明作品的归属。这个许可协议非常的有用，它可以让你的作品传播出去，但又可以对作品的使用保留部分或完全的控制。最少限制的CC协议类型当属 “署名”协议，这意味着只要人们能维护你的名誉，他们对你的作品怎么使用都行。

CC 许可协议更多的是在设计类工程中使用，而不是开发类，但没有人或妨碍你将之使用与后者。只是你必须要清楚各部分条款能覆盖到的和不能覆盖到的权利。

图解分析

正则表达式语法介绍

Wu — Sun, 28 Dec 2025 03:16:55 +0000

正则表达式（Regular Expression，简称 Regex）是一种强大的文本处理工具，它使用一种简洁而又复杂的语法来匹配、查找和替换文本中的特定模式。无论是进行数据验证、日志分析、文本清理还是复杂的字符串匹配，正则表达式都能提供高效的解决方案。本篇文章将深入探讨正则表达式的语法、常见误区以及常用示例，帮助你更好地掌握这一工具。

一、正则表达式基本语法解析

1. 基础字符

.：匹配除换行符之外的任何单个字符。
- 示例：a.b 匹配 aab、acb，但不匹配 ab。
\d：匹配一个数字字符，等同于 [0-9]。
- 示例：\d{3} 匹配 123。
\D：匹配一个非数字字符，等同于 [^0-9]。
- 示例：\D{3} 匹配 abc。

2. 字符类

[abc]：匹配 a、b 或 c 中的任意一个字符。
- 示例：[aeiou] 匹配任意元音字母。
[^abc]：匹配除 a、b 或 c 之外的任何字符。
- 示例：[^0-9] 匹配非数字字符。

3. 特殊字符

\：转义字符，用于匹配特殊字符本身，如 \.、\* 等。
- 示例：\. 匹配点号字符 .。
\b：单词边界，匹配单词的开始或结束位置。
- 示例：\bword\b 匹配以 word 为完整单词的地方。
\B：非单词边界，匹配不在单词边界上的位置。
- 示例：a\Bb 匹配 ab，但不匹配 a b。

4. 元字符与量词

*：匹配前一个字符零次或多次。
- 示例：a* 匹配 ""（空字符串）、a、aa 等。
+：匹配前一个字符一次或多次。
- 示例：a+ 匹配 a、aa、aaa 等，但不匹配 ""。
?：匹配前一个字符零次或一次。
- 示例：a? 匹配 "" 或 a。
{n}：匹配前一个字符恰好 n 次。
- 示例：a{3} 匹配 aaa。
{n,}：匹配前一个字符至少 n 次。
- 示例：a{2,} 匹配 aa、aaa 等。
{n,m}：匹配前一个字符至少 n 次，但不超过 m 次。
- 示例：a{2,4} 匹配 aa、aaa、aaaa。

5. 分组与选择

()：用于分组，匹配的内容可以通过反向引用 \1、\2 等进行使用。
- 示例：(abc) 匹配 abc，并且可以通过 \1 引用。
|：选择符，表示 “或” 的关系。
- 示例：a|b 匹配 a 或 b。

6. 断言

(?=...)：正向前瞻，匹配后面跟着特定模式的地方，但不消费字符。
- 示例：a(?=b) 匹配 a，但要求其后必须是 b。
(?!...)：负向前瞻，匹配后面不跟着特定模式的地方。
- 示例：a(?!b) 匹配 a，但要求其后不跟 b。

7. 贪婪与非贪婪

正则表达式的量词（如 *、+ 等）默认是贪婪的，会尽可能多地匹配字符。但有时我们希望它们匹配最少的字符，可以使用非贪婪匹配。

贪婪：*、+、{n,m} 默认是贪婪的，尽可能多地匹配字符。
- 示例：a.*b 匹配 a 和 b 之间的所有字符。
非贪婪：在量词后加上 ?，即变为非贪婪模式。
- 示例：a.*?b 匹配 a 和 b 之间的最少字符。

二、正则表达式的常见误区与避坑指南

字符类的误用：
- . 匹配任意字符，但不要混淆它与 \.。如果你想匹配点号，必须使用 \.。
- \d 和 \D 只能匹配数字和非数字字符，不能匹配空格或字母等。
量词的贪婪性：
- 很多初学者容易忽略贪婪匹配的行为，导致正则表达式匹配到比预期更多的内容。通过使用非贪婪量词（*?、+?）可以避免这个问题。
正则表达式的效率问题：
- 正则表达式的效率会随着匹配文本的复杂度增加而下降。避免使用过于复杂的正则模式，尤其是在大数据量的情况下，可能会导致性能瓶颈。
捕获组的使用：
- 捕获组会保存匹配的内容，如果不需要这些内容，可以使用非捕获组 (?:...) 来优化性能。

三、常用正则表达式示例

验证邮箱地址：
- 正则：^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
- 解析：匹配合法的邮箱格式。
验证手机号：
- 正则：^1[3-9]\d{9}$
- 解析：匹配中国大陆的手机号，第一位是 1，第二位是 3-9 中的数字，后面跟着 9 个数字。
提取网页链接中的域名：
- 正则：https?://([^/]+)
- 解析：匹配 http 或 https 开头的链接并提取域名部分。
匹配日期格式（yyyy-mm-dd）：
- 正则：^\d{4}-\d{2}-\d{2}$
- 解析：匹配一个符合 yyyy-mm-dd 格式的日期。
匹配时间格式（HH:mm:ss）：
- 正则：^([01]?[0-9]|2[0-3]):([0-5]?[0-9]):([0-5]?[0-9])$
- 解析：匹配符合 HH:mm:ss 格式的时间。
匹配正整数：
- 正则：^\d+$
- 解析：匹配一个正整数。