Markdown使用

Markdown学习

好的，Markdown语法非常简洁易学，它让你能专注于内容本身，而不用过多地操心排版。

这是一份从基础到高级的完整Markdown语法指南。

一、 基础语法

这些是日常写作中最常用的语法。

语法 效果 备注

一级标题

一级标题

用 # 的数量表示标题级别，从 H1 到 H6

二级标题

二级标题

粗体文本 粗体文本 也可以用 双下划线
斜体文本 斜体文本 也可以用 单下划线
删除线 删除线
行内代码 行内代码 用于显示短代码或关键字
链接文本 链接文本
显示图片 方括号里是图片加载失败时的替代文本

引用内容 引用内容

• 无序列表项
  • 无序列表项
  用 -, +, * 都可以

1. 有序列表项
   1. 有序列表项
   
   --- 一条水平分割线 也可以用 *** 或 ___

---

二、 进阶语法（表格与代码块）

1. 表格

使用连字符 - 分隔表头和内容，冒号 : 用于指定对齐方式。

| 左对齐 | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 单元格 | 单元格 | 单元格 |
| 内容 | 内容 | 内容 |

效果：

左对齐 居中对齐 右对齐
单元格 单元格 单元格
内容 内容 内容

2. 代码块

用三个反引号 ````` 包裹代码，并可在开头指定语言以实现语法高亮。

```python
def hello_world():# 这是一个Python示例print("Hello, World!")
```

效果：

def hello_world():# 这是一个Python示例print("Hello, World!")

---

三、 扩展语法（GFM及类似扩展）

许多平台（如 GitHub、GitLab、飞书等）在标准 Markdown 基础上进行了扩展，称为 GFM。

功能 语法 效果/说明
任务列表 - [x] 已完成任务 - [ ] 未完成任务 - [x] 已完成任务 - [ ] 未完成任务
脚注 这是一个带有脚注的句子[^1]。 [^1]: 这里是脚注的内容。 这是一个带有脚注的句子[^1]。
定义列表 术语 : 这是术语的定义 术语 : 这是术语的定义
高亮 这是高亮文本 这是高亮文本 (部分平台支持)
上标/下标 H₂O 和 X² H₂O 和 X² (部分平台支持)

---

四、 高级用法（流程图等）

在一些支持 Mermaid 库的编辑器（如 Typora、VS Code 的插件、飞书）中，你甚至可以绘制图表。

流程图示例

```mermaid
graph TDA[开始] --> B{判断}B -->|是| C[执行操作A]B -->|否| D[执行操作B]C --> E[结束]D --> E
```

效果：

graph TDA[开始] --> B{判断}B -->|是| C[执行操作A]B -->|否| D[执行操作B]C --> E[结束]D --> E

💡 使用小贴士

1. 兼容性提醒：不是所有 Markdown 编辑器或网站都支持全部扩展语法。在使用前，最好先确认你所在平台的支持情况。
2. 混合使用：大部分语法可以混合使用，例如 > ## 这是一个引用内的标题 或者 粗体斜体粗体。
3. 练习工具：推荐使用 Typora 或 VS Code（搭配 Markdown 插件）来练习，它们可以实时预览渲染效果。

这份指南几乎涵盖了所有你会用到的 Markdown 语法。从今天开始，尝试用 Markdown 来写笔记或文档吧，你会发现它无比高效！