CK

Welcome

欢迎来到CK的博客！

了解更多

标签

1641 字

8 分钟

Markdown基本语法介绍

2025-12-18

技术

Markdown

/

Blogging

Markdown基本语法#

本文来源：Mizuki Next Theme

基础#

Markdown 是一种轻量级标记语言，通过简单标记语法，让普通文本具备格式化效果，核心目标是「易读易写」—— 纯文本编写，无复杂标签，直接阅读也清晰易懂。

一、概述#

核心特性#

可读性优先：纯文本格式，无冗余标签，直接阅读也自然流畅
语法简洁：基于标点符号设计，标记与语义高度一致（如 *强调* 直观易懂）
兼容性强：衍生版本丰富（Markdown Extra、MultiMarkdown 等），支持扩展表格、脚注等功能，可转换为 HTML、LaTeX、Docbook 等格式
灵感来源：源自纯文本电子邮件格式，兼顾写作效率与展示效果

主要用途#

撰写博客（支持 WordPress 等主流平台）
编写项目说明文档（如 README.md）
快速生成演讲 PPT、Word 文档、LaTeX 论文
数据科学领域：支持动态可重复性研究文档

二、块元素#

1. 段落和换行#

段落：由连续行组成，空行（含仅空格/tab的行）分隔不同段落，无需缩进

强制换行：行尾加 2 个以上空格 + 回车，或用反斜线 \ + 回车

1
这是第一段，行尾加两个空格
2
强制换行显示
3
这是第二段（与上一段空行分隔）
4
这是第三段\
5
反斜线换行示例

2. 标题#

支持两种语法，推荐使用 Atx 形式（更灵活）：

Atx 形式（推荐）#

1
# H1 一级标题
2
## H2 二级标题
3
### H3 三级标题
4
#### H4 四级标题
5
##### H5 五级标题
6
###### H6 六级标题

Setext 形式（仅支持 H1-H2）#

1
H1 一级标题
2
===
3
H2 二级标题
4
---

3. 块引言#

行首加 > ，支持嵌套（多层 >）和内部嵌套其他语法
可仅在段落第一行加 >，后续行自动继承

1
> 一级引言段落1
2
> 一级引言段落2
3
>
4
> > 嵌套二级引言
5
>
6
> 回到一级引言，支持嵌套列表：
7
> 1. 引言内有序列表
8
> 2. 列表项2
9
>
10
> > ## 引言内标题
11
> > `引言内代码`

4. 列表#

无序列表#

支持 -、*、+ 作为标记（推荐 -），标记后需加空格

1
- 无序列表项1
2
- 无序列表项2
3
  - 嵌套子项（缩进 3 空格或 1 tab）
4
  - 嵌套子项
5
* 星号标记项（不推荐混合使用）
6
+ 加号标记项（不推荐混合使用）

有序列表#

数字 + 英文句点 + 空格，数字不影响最终排序（可统一用 1.）

1
1. 有序列表项1
2
1. 有序列表项2
3
  1. 嵌套子项（缩进）
4
  2. 嵌套子项
5
3. 有序列表项3

列表高级用法#

列表项含多段落：子段落需缩进 3 空格
列表项间空行：自动为内容添加 <p> 标签（更美观）
避免误触发：行首数字+句点前加反斜线 \（如 1986\. 年份说明）

1
- 列表项1（含多段落）
2
  子段落内容（缩进 3 空格）
3
  子段落2
4

5
- 列表项2（空行分隔，自动加<p>标签）

5. 代码块#

基础用法（缩进式）#

行首缩进 4 空格或 1 tab，适用于短代码块

1
普通段落：
2
    const a = 1; // 缩进 4 空格的代码块
3
    console.log(a);

进阶用法（围栏式，推荐）#

用 ``` 或 ````` 包裹，支持指定语言高亮（推荐）

1
```js
2
// 指定 JavaScript 语法高亮
3
function demo() {
4
  return "代码块";
5
}

// 嵌套代码块（外层用更多反引号）

1
```html
2
<div>嵌套代码块示例</div>
3
```

1
### 6. 分隔线
2
一行内用 3 个以上 `*`、`-`、`_`，行内无其他内容
3
```markdown
4
内容1
5
---
6
内容2
7
***
8
内容3
9
___

三、行内元素#

1. 链接#

行内链接（推荐，直观）#

1
[链接文本](https://example.com "可选标题，hover显示")
2
[相对路径链接](/about/ "内部页面")
3
[无标题链接](https://example.com)

参考式链接（适合多次引用同一链接）#

1
// 正文引用
2
这是[示例链接][id1]，这是[重复引用链接][id1]
3

4
// 链接定义（可放文末）
5
[id1]: https://example.com "可选标题"
6
[google]: https://google.com/ "Google"
7

8
// 简化写法（链接文本=标识ID）
9
[Google][]
10
[google]: https://google.com/

2. 强调#

单 * 或 _：斜体（<em>）
双 * 或 _：粗体（<strong>）
符号需成对使用，不可混合

1
*斜体文本*（推荐）
2
_斜体文本_
3
**粗体文本**（推荐）
4
__粗体文本__
5
***粗斜体文本***

3. 行内代码#

用反引号 ` 包裹，含反引号时用多组反引号

1
行内代码：`console.log("hello")`
2
含反引号的代码：`` `code` 中的反引号 ``
3
HTML 标签示例：`<div class="demo">`

4. 图片#

语法与链接类似，前缀加 !，无宽高控制语法（需宽高时用 <img> 标签）

行内图片#

1
![替代文本（图片加载失败显示）](/path/to/img.webp "可选标题")
2
![网络图片](https://example.com/img.jpg)

参考式图片#

1
![替代文本][imgId]
2
[imgId]: /path/to/img.webp "可选标题"

自定义宽高（HTML 标签）#

1
<img src="/path/to/img.webp" alt="替代文本" width="300" height="200">

5. 其他行内样式#

效果	Markdown 语法	说明
删除线	`~~删除文本~~`	双波浪线包裹
换行	行尾加 2 空格 + 回车	强制换行
表情符号	`:emoji名称:`	例：`:smile:` → 😄

四、扩展功能#

1. 表格#

表头与内容用 - 分隔，: 控制对齐（无 : 则默认左对齐）
- 数量至少 1 个，可灵活调整

1
| 左对齐 | 居中对齐 | 右对齐 |
2
| :----- | :------: | -----: |
3
| 内容1  | 内容2    | 内容3  |
4
| 长文本内容 | 居中示例 | 数值100 |

2. 自动链接#

无需标记文本，直接用 <> 包裹网址或邮箱

1
<https://example.com>
2
<contact@example.com>

3. 转义字符#

用反斜线 \ 转义 Markdown 特殊符号，支持转义的符号：

1
\   反斜线
2
`   反引号
3
*   星号
4
_   底线
5
{}  大括号
6
[]  方括号
7
()  括号
8
#   井字号
9
+   加号
10
-   减号
11
.   英文句点
12
!   惊叹号

示例：\*这不是斜体\* → 这不是斜体

4. 行内 HTML#

支持直接插入 HTML 标签，块级标签需前后空行，且不缩进

1
普通段落
2

3
<div style="color: red;">HTML 块级标签，前后空行</div>
4

5
<span style="color: blue;">行内 HTML 标签</span>

注意：HTML 块内不解析 Markdown 语法

5. 快捷键#

效果	Markdown 语法	快捷键（Windows/Linux）	快捷键（Mac）
粗体	`文本`	Ctrl + B	⌘ + B
斜体	`文本`	Ctrl + I	⌘ + I
行内代码	`代码`	选中内容 + `	选中内容 + `
链接	`[文本](链接)`	Ctrl + K	⌘ + K
图片	`![文本](路径)`	Ctrl + Shift + I	⌘ + Shift + I

五、注意事项#

语法兼容性：不同平台（GitHub、掘金等）对扩展语法（如表格、脚注）支持有差异，需按需调整
图片路径：遵循前端资源路径规则（/ 开头对应 public 目录，无 / 对应相对目录）
性能优化：图片推荐用 WebP 格式，文档中避免冗余标记，保持可读性