Skip to main content

Markdown 语法指南

📋 目录

  • #基础语法
  • #高级功能
  • #扩展语法
  • #实用技巧

📝 基础语法

1. 标题

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

2. 文本样式

**粗体文本**
*斜体文本*
~~删除线文本~~
***粗斜体文本***

3. 列表

无序列表

- 项目一
- 项目二
  - 子项目
  - 子项目
* 也可用星号

有序列表

1. 第一项
2. 第二项
   1. 子项
   2. 子项
3. 第三项

4. 链接

https://example.com
https://example.com "标题"

5. 图片

!图片地址
!图片地址 "标题"

6. 引用

> 引用内容
> 多行引用
>> 嵌套引用

7. 代码

行内代码：`代码` 代码块：

代码块

```python
# 指定语言
print("Hello World")


### 8. 水平线
```markdown
---
***
___

🚀 高级功能

9. 表格

| 表头1 | 表头2 | 表头3 |
|-------|-------|-------|
| 内容1 | 内容2 | 内容3 |
| 左对齐 | 居中对齐 | 右对齐 |

对齐方式：

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

10. 任务列表

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

11. 脚注

这是一句话。
这是另一句话。

: 第一个脚注说明
: 第二个脚注说明

🔧 扩展语法（部分平台支持）

12. 数学公式

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

块级公式：
$$
f(x) = \int_{-\infty}^{\infty} \hat f(\xi) e^{2\pi i \xi x} d\xi
$$

13. 图表

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


### 14. 注释
```markdown
<!-- 这是注释，不会显示 -->

15. 定义列表

术语1
: 定义1

术语2
: 定义2

💡 实用技巧

16. 转义字符

\# 显示井号
\* 显示星号
\_ 显示下划线

17. 自动链接

<https://example.com>
<email@example.com>

18. 目录（部分平台）

[TOC]

19. 折叠内容

<details>
<summary>点击展开</summary>

折叠内容

- 列表
- 可以
- 包含任何内容
</details>

🎯 最佳实践

  1. 标题层次：保持标题层级结构清晰
  2. 代码块：总是指定语言以获得语法高亮
  3. 表格对齐：使用对齐符号提高可读性
  4. 链接引用：长链接使用引用样式
  5. 保持简洁：避免过度复杂的嵌套

🔄 兼容性说明

功能 GitHub GitLab 其他平台
表格 ✅ ✅ 大部分
任务列表 ✅ ✅ 部分
数学公式 ❌ ✅ 看支持
Mermaid ✅ ✅ 看支持

💡 提示：不同平台对 Markdown 的支持程度可能不同，使用前请检查目标平台的文档。

Back to top