Markdown的基础使用方法

骚年
骚年
管理员
33
文章
0
粉丝
感兴趣的研究评论6阅读模式

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. 图片

语法:![图片描述](图片URL "可选标题"),描述用于图片加载失败时显示:

![Markdown图标](https://markdown-here.com/img/icon256.png "Markdown Logo")

渲染效果:
Markdown的基础使用方法

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

注意:

  • 表格的 | 可以不对齐,不影响渲染;
  • : 位置:左对齐 :---、居中 :---:、右对齐 ---:

四、特殊用法(兼容性说明)

  1. 脚注:部分编辑器(Typora/GitHub)支持,语法:
这是需要注释的文本[^1]

[^1]: 这是脚注的内容,通常放文档末尾
  1. 数学公式:用 $ 包裹(LaTeX 语法),需编辑器支持(如 Typora/Notion):
行内公式:$E=mc^2$
块级公式:
$$
\sum_{i=1}^n i = \frac{n(n+1)}{2}
$$
  1. HTML 嵌套:Markdown 兼容 HTML,可补充不支持的格式(如换行 <br>、居中 <center>):
<center>居中的文本</center>
换行前<br>换行后

 

五、核心注意事项

  1. 兼容性:不同平台(GitHub/CSDN/Typora/Notion)对 Markdown 扩展语法(如下标/高亮/脚注)支持度不同,优先用基础语法;
  2. 换行:Markdown 中直接回车不会换行,需加两个空格+回车,或用
  3. 转义字符:如需显示 */#/[ 等特殊符号,加 \ 转义:\*不需要加粗\* → *不需要加粗*;
  4. 空行:不同区块(标题/列表/引用)之间加空行,排版更清晰。

掌握以上用法,足以应对 99% 的日常写作(文档/笔记/代码注释/论坛发帖等),建议结合实际场景多练,比如用 Typora 实时预览效果,快速熟悉。

这小玩意还挺有意思?!是吧!

 
骚年
  • 本文由 骚年 发表于2025年12月24日 08:35:42
  • 转载请务必保留本文链接:https://cexunke.com/ganxingqudeyanjiu/200.html
匿名

发表评论

匿名网友
确定

拖动滑块以完成验证