STLG_04_03_Markdown - 高级语法

一、Markdown 简介

1.1 什么是 Markdown？

Markdown 是一种轻量级的标记语言，它的设计初衷是为了用纯文本格式编写文档，而这些文档可以在浏览器中被转换为结构良好的HTML文档。Markdown 语法简洁，易于阅读和书写，因此在撰写技术文档、博客文章、README文件等方面得到了广泛应用。

1.2 Markdown 的优势

• 简洁易读：Markdown 语法非常简单，不需要复杂的标签和格式，学习成本低。
• 可读性强：即使在没有渲染的情况下，Markdown 文本也具有良好的可读性。
• 兼容性好：Markdown 可以轻松转换为HTML、PDF等格式，适合多种场景。
• 广泛应用：Markdown 被广泛应用于 GitHub、CSDN、博客园等平台，是技术人员和写作者的必备技能。

1.3 学习 Markdown 的意义

对于初学者来说，学习 Markdown 可以让你快速上手文档编写，无论是写技术博客、项目文档，还是日常笔记，Markdown 都能让你的内容更加清晰、美观。

---

二、Markdown 高级语法详解

Markdown 的基础语法（如标题、段落、列表等）是入门的第一步，但要想写出更专业、更美观的文档，掌握高级语法是必不可少的。以下是 Markdown 高级语法的详细讲解。

2.1 链接

链接是 Markdown 中非常常用的功能，可以用来插入外部网页、文档或其他资源。Markdown 提供了两种插入链接的方式：行内风格和参考风格。

2.1.1 行内风格链接

行内风格的链接是将链接地址直接嵌入到链接文本中，格式如下：

[链接文本](链接地址 "可选的链接提示信息")

• 链接文本：用户点击的部分，可以是文字或图片。
• 链接地址：实际跳转的网址。
• 可选的链接提示信息：当用户鼠标悬停在链接上时显示的提示信息。

示例：

[百度](https://www.baidu.com "访问百度")

渲染结果：

百度

2.1.2 参考风格链接

参考风格的链接允许你将链接地址与链接文本分开写，便于管理和维护。适合在长文档中使用，格式如下：

[链接文本][标签]

[标签]: 链接地址 "可选的链接提示信息"

• 标签：一个标识符，可以是任意字符，通常选择简短易记的名称。
• 链接地址：实际跳转的网址。
• 可选的链接提示信息：同上。

示例：

[百度][baidu]

[baidu]: https://www.baidu.com "访问百度"

渲染结果：

百度

2.2 图片

图片的插入与链接非常相似，只是在链接的前面加一个感叹号 !。图片通常用于插入图示、截图等。

2.2.1 插入图片的语法

![图片描述](图片URL "可选的提示信息")

• 图片描述：当图片无法显示时，显示的替代文本。
• 图片URL：图片的实际地址，可以是本地路径或网络链接。
• 可选的提示信息：当用户鼠标悬停在图片上时显示的提示信息。

示例：

![美丽的风景](https://example.com/image.jpg "自然风景")

渲染结果：

注意：如果你使用本地图片，可以使用相对路径，例如：![本地图片](./images/image.jpg)。

2.3 代码

代码是 Markdown 中非常重要的部分，无论是展示代码片段，还是保持代码的格式，Markdown 都提供了多种方式。

2.3.1 行内代码

行内代码用于在文本中插入一小段代码，通常用于变量名、函数名等。使用反引号 ` 包围代码。

语法：

`这里是一行代码`

示例：

我正在使用的变量是 `count`。

渲染结果：

我正在使用的变量是 count。

2.3.2 代码块

代码块用于展示多行代码，并且可以指定编程语言，以便代码高亮显示。使用三对反引号 ``` 包围代码块。

语法：

```编程语言
代码块内容

**示例：**

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

**渲染结果：**

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

常见的编程语言：python、javascript、java、html、css 等。

2.4 表格

表格是 Markdown 中用于展示结构化数据的工具。虽然 Markdown 的表格功能不如 Excel 或 HTML 表格灵活，但它足够满足大多数场景的需求。

2.4.1 表格的基本语法

| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 内容A | 内容B | 内容C |
| 内容1 | 内容2 | 内容3 |

• 第一行：定义表头。
• 第二行：定义列的对齐方式和表格的分割线。
• 后续行：表格的实际内容。

示例：

| 列1 | 列2 | 列3 |
| --- | --- | --- |
| 内容A | 内容B | 内容C |
| 内容1 | 内容2 | 内容3 |

渲染结果：

列1	列2	列3
内容A	内容B	内容C
内容1	内容2	内容3

2.4.2 表格的对齐方式

在表格的第二行中，可以通过 - 的排列来定义列的对齐方式：

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

示例：

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 内容A | 内容B | 内容C |
| 内容1 | 内容2 | 内容3 |

渲染结果：

左对齐	居中对齐	右对齐
内容A	内容B	内容C
内容1	内容2	内容3

2.5 其他高级功能

除了以上常用的高级语法外，Markdown 还支持一些扩展功能，如任务列表、注释、脚注等。

2.5.1 任务列表

任务列表用于创建带有复选框的列表，常用于待办事项。

语法：

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

示例：

- [x] 完成项目文档
- [ ] 提交代码

渲染结果：

• [x] 完成项目文档
• [ ] 提交代码

---

三、总结

Markdown 是一种简单而强大的标记语言，掌握其高级语法可以让你的文档更加专业、美观。通过学习链接、图片、代码、表格等高级语法，你可以轻松编写出结构清晰、内容丰富的文档。

无论你是初学者还是有经验的写作者，Markdown 都能为你的工作带来极大的便利。希望本篇笔记能帮助你更好地掌握 Markdown 的高级用法，提升你的写作效率！

如果你有任何问题或建议，欢迎在评论区留言交流！