Markdown 核心标识用法全解析
Markdown 是一种轻量级标记语言,核心是用简单的符号替代复杂的 HTML 标签,兼容所有文本编辑器,且能快速渲染为美观的格式。本文整理了最常用的 Markdown 标识用法,按「基础格式」「结构化内容」「进阶功能」分类,附示例和注意事项,新手也能快速掌握。
一、基础文本格式(最常用)
| 功能 | 标识语法 | 示例 | 渲染效果 |
|---|---|---|---|
| 加粗 | **文本** 或 __文本__ |
**重点内容** |
重点内容 |
| 斜体 | *文本* 或 _文本_ |
*强调内容* |
强调内容 |
| 加粗+斜体 | ***文本*** 或 ___文本___ |
***核心重点*** |
核心重点 |
| 删除线 | ~~文本~~ |
~~作废内容~~ |
|
| 行内代码 | `代码片段` |
sudo apt update |
sudo apt update |
| 下标 | 文本~下标~(部分编辑器支持) |
H~2~O |
H₂O |
| 上标 | 文本^上标^(部分编辑器支持) |
2^10^ |
2¹⁰ |
| 高亮 | ==文本==(部分编辑器支持) |
==关键数据== |
==关键数据== |
注意:
- 加粗/斜体的符号与文本之间不要加空格(如
** 错误 **不会生效); - 行内代码适合短代码片段,长代码块用「代码块」语法(下文)。
二、结构化内容(排版核心)
1. 标题(分级)
用 # 表示层级,# 越多级别越低(1-6级),# 与标题之间加一个空格:
# 一级标题(最大)
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(最小)
注意:
- 一级/二级标题常用作章节标题,六级标题几乎不用;
- 部分平台(如 GitHub)会自动为标题生成锚点,可跳转。
2. 列表
(1)无序列表(项目符号)
用 */+/- 开头,符号与文本之间加空格,支持嵌套:
- 列表项1
- 子列表项1.1
- 子列表项1.2
+ 列表项2
* 列表项3
渲染效果:
- 列表项1
- 子列表项1.1
- 子列表项1.2
+ 列表项2
* 列表项3
(2)有序列表(数字编号)
用「数字+.」开头,数字顺序不影响渲染(推荐按自然顺序写),支持嵌套:
1. 第一步:安装依赖
1. 子步骤1:更新源
2. 子步骤2:安装包
2. 第二步:配置参数
3. 第三步:验证结果
渲染效果:
1. 第一步:安装依赖
1. 子步骤1:更新源
2. 子步骤2:安装包
2. 第二步:配置参数
3. 第三步:验证结果
(3)任务列表(复选框)
用 - [ ](未完成)/ - [x](已完成),部分平台(GitHub/Notion)支持:
- [x] 完成脚本编写
- [ ] 测试兼容性
- [ ] 编写文档
渲染效果:
- [x] 完成脚本编写
- [ ] 测试兼容性
- [ ] 编写文档
3. 引用(blockquote)
用 > 开头,支持多层嵌套(多一个 > 缩进一级),可嵌套其他格式:
> 一级引用:这是一段引用文本
>> 二级引用:嵌套的引用内容
>> *引用内的斜体*
> 回到一级引用
渲染效果:
一级引用:这是一段引用文本
> 二级引用:嵌套的引用内容
> 引用内的斜体
回到一级引用
4. 分割线
用 ---/***/___(至少3个符号),单独占一行,前后空行更美观:
文本内容
---
后续内容
渲染效果:
文本内容
后续内容
三、进阶功能(提升可读性)
1. 代码块(多行代码)
(1)基础代码块
用 ``` 包裹,单独占行,支持指定编程语言(自动语法高亮):
```bash
# 这是bash脚本示例
chmod +x time-sync-shanghai.sh
./time-sync-shanghai.sh
# 这是Python示例
print("Hello Markdown")
#### (2)效果:
```bash
# 这是bash脚本示例
chmod +x time-sync-shanghai.sh
./time-sync-shanghai.sh
# 这是Python示例
print("Hello Markdown")
2. 链接
(1)行内链接
语法:[链接文本](URL "可选标题"),标题 hover 时显示:
[阿里云NTP服务器](https://www.aliyun.com "阿里云官网")
渲染效果:阿里云NTP服务器
(2)参考式链接(适合重复使用)
先定义链接标识,再引用,适合长文档:
# 定义链接(可放文档末尾) [ntp]: https://ntp.aliyun.com "阿里云NTP" # 引用链接 同步时间请使用[阿里云NTP][ntp]服务器
渲染效果:同步时间请使用阿里云NTP服务器
(3)锚点链接(跳转到文档内标题)
语法:[跳转到标题](#标题名称),标题名称需小写,空格替换为 -:
[跳转到代码块](#1-代码块多行代码)
3. 图片
语法:,描述用于图片加载失败时显示:

渲染效果:
![]()
4. 表格
用 | 分隔列,- 分隔表头和内容,: 控制对齐(左/中/右):
| 系统类型 | 包管理器 | 安装命令 |
| :------- | :------: | -------------: |
| Ubuntu | apt | apt install -y |
| CentOS | yum | yum install -y |
| Alpine | apk | apk add --no-cache |
渲染效果:
| 系统类型 | 包管理器 | 安装命令 |
|---|---|---|
| Ubuntu | apt | apt install -y |
| CentOS | yum | yum install -y |
| Alpine | apk | apk add --no-cache |
注意:
- 表格的
|可以不对齐,不影响渲染; :位置:左对齐:---、居中:---:、右对齐---:。
四、特殊用法(兼容性说明)
- 脚注:部分编辑器(Typora/GitHub)支持,语法:
这是需要注释的文本[^1] [^1]: 这是脚注的内容,通常放文档末尾
- 数学公式:用
$包裹(LaTeX 语法),需编辑器支持(如 Typora/Notion):
行内公式:$E=mc^2$
块级公式:
$$
\sum_{i=1}^n i = \frac{n(n+1)}{2}
$$
- HTML 嵌套:Markdown 兼容 HTML,可补充不支持的格式(如换行
<br>、居中<center>):
<center>居中的文本</center> 换行前<br>换行后
五、核心注意事项
- 兼容性:不同平台(GitHub/CSDN/Typora/Notion)对 Markdown 扩展语法(如下标/高亮/脚注)支持度不同,优先用基础语法;
- 换行:Markdown 中直接回车不会换行,需加两个空格+回车,或用
; - 转义字符:如需显示
*/#/[等特殊符号,加\转义:\*不需要加粗\*→ *不需要加粗*; - 空行:不同区块(标题/列表/引用)之间加空行,排版更清晰。
掌握以上用法,足以应对 99% 的日常写作(文档/笔记/代码注释/论坛发帖等),建议结合实际场景多练,比如用 Typora 实时预览效果,快速熟悉。
这小玩意还挺有意思?!是吧!

