Skip to content

Markdown语法

基础语法

标题

使用 # 符号,数量代表级别(1-6级)。

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

注: # 和文字之间建议保留一个空格。


段落与换行

  • 段落:直接连续书写,空一行表示分段。
  • 换行:行末敲 两个空格 再回车;或者直接使用 <br> 标签。
markdown
这是第一段。
(此处空一行)
这是第二段。

这是第一行(末尾两个空格)  
这是第二行(软换行)

强调(字体样式)

效果语法示例
加粗**文字**__文字__加粗
斜体*文字*_文字_斜体
加粗斜体***文字***加粗斜体
删除线~~文字~~删除线
下划线<u>文字</u>(HTML标签)下划线

列表

无序列表(使用 - * +

markdown
- 项目1
- 项目2
  - 子项目2.1(缩进2或4空格)
  - 子项目2.2

有序列表(数字 + 点)

markdown
1. 第一步
2. 第二步
   3. 子步骤2.1(缩进3空格)
   4. 子步骤2.2

技巧: 数字不必真实,Markdown 会自动排序,但建议按实际写。

任务列表(待办事项)

markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 子任务(缩进)

链接与图片

链接

markdown
[显示文字](https://example.com "悬停标题(可选)")

图片(比链接多一个 !

markdown
![替代文字](https://example.com/image.jpg "图片标题")

引用式链接(高级用法,便于复用)

markdown
[显示文字][引用ID]

[引用ID]: https://example.com "说明"

引用(Blockquote)

使用 > 符号,可嵌套。

markdown
> 这是一级引用。
> > 这是二级引用(嵌套)。
> 回到一级。

代码

行内代码(使用反引号 `

markdown
请使用 `print("Hello")` 函数输出。

代码块(使用三个反引号 ``` 或缩进4空格)

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

指定语言(第一个反引号后跟语言名)可实现语法高亮(需渲染器支持)。


进阶语法

分割线

使用三个或以上的 - * _(需独占一行)。

markdown
---
***
___

表格

语法要点:

  • 表头与内容用 |---| 分隔(: 控制对齐方向)。
  • 列数需一致。
markdown
| 左对齐(默认) | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |

转义字符

使用反斜杠 \ 转义 Markdown 特殊符号。

markdown
\* 这不是斜体 \*
\# 这不是标题

HTML 标签(补充能力)

Markdown 支持内联 HTML(在大多数平台),可用于实现原生语法不支持的效果:

html
<!-- 换行 -->
<br>

<!-- 居中(部分平台支持) -->
<center>居中文字</center>

<!-- 字体颜色(部分平台支持) -->
<font color="red">红色文字</font>

<!-- 键盘按键 -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>

扩展语法

GFM(GitHub Flavored Markdown) 是 GitHub 的扩展标准,多数现代编辑器支持。

自动链接

直接写 URL(带协议),会自动变成可点击链接。

markdown
https://www.example.com
<user@example.com>  <!-- 邮箱自动链接 -->

脚注(Footnote)

markdown
这是带脚注的文字[^1]。

[^1]: 这里是脚注内容。

删除线(已在基础部分提及,但 GFM 标准)

~~删除文字~~


表情符号(Emoji)

  • 直接复制粘贴 😊。
  • 或使用短代码(如 :smile:),需平台支持(GitHub 支持)。

高亮(Highlight)

非标准,部分编辑器支持:

markdown
==高亮文字==

上标与下标(使用 HTML 或 LaTeX)

markdown
H<sub>2</sub>O          <!-- 下标 -->
x<sup>2</sup>           <!-- 上标 -->

数学公式(LaTeX,需渲染器支持如 MathJax)

markdown
行内公式:$E = mc^2$

公式块:
$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$

常用写作技巧与最佳实践

保持空行规范

  • 标题、列表、代码块、表格前后各空一行(增强可读性)。

统一符号风格

  • 列表统一用 -(或 *),不要混用。

图片尺寸控制(使用 HTML)

html
<img src="image.jpg" width="300" alt="描述">

锚点跳转(页面内跳转)

  • 标题会自动生成 id(一般规则:小写、空格转连字符)。
markdown
[跳转到基础部分](#第一部分基础语法-80-日常使用)

渲染差异说明

平台/工具差异点
GitHub支持 GFM、任务列表、emoji短码
Typora/Obsidian支持高亮、数学公式、图表
知乎/微信公众号支持有限,多数需用在线编辑器转换
Notion部分语法不同(如 / 命令替代部分原生)

速查卡片

markdown
# 标题
**加粗**  *斜体*  ~~删除线~~
- 无序列表
1. 有序列表
- [ ] 任务列表
[链接](url)  ![图片](url)
> 引用
`行内代码`
```代码块```
| 表格 | 表格 |
|------|------|
| 内容 | 内容 |
--- 分割线
最近更新