Markdown 基本语法速查

2026-10-13

Markdown基本语法

分割线多个---------或**然后回车即可

标题

要创建标题，请在单词或短语前面添加井号 (#) 加空格。# 的数量代表了标题的级别。例如，添加三个 # 表示创建一个三级标题

~level

ctrl +/-升降标题等级

Heading level 1

段落

空一行或多行分割段落

在一行的末尾添加两个或多个空格，然后按回车键,即可创建一个换行(<br>)

First line with two spaces after.
And the next line.

强调

在句子前后加两个*或者_____

如果同时加粗和斜体就三个*/_

引用

要创建块引用，请在段落前添加一个 > 符号。如果需要嵌套再加一个>

引用块

支持嵌套引用

带有其他元素的块引用如

加粗

斜体

  • *加一个制表符 shift+回车强制换行

  • 加空格

  • ffhh

    • -加制表符/空格

列表

有序

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。

1.一

2.

5.

​ 1.

​ 2.

4.

无序

要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。

*11

*22

  • 简介

嵌套

段落

  • 项目符号

引用

代码块

CTRL+shift+K

公式块

$$ ctrl+shift+M $$

表格

CTRL+T

代码

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中

分割线

要创建分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ，并且不能包含其他内容

以上三个分隔线的渲染效果看起来都一样

链接

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

超链接Markdown语法代码：[超链接显示名](超链接地址 "超链接title") CTRL+单击访问链接

title

链接title是当鼠标悬停在链接上时会出现的文字，这个title是可选的，它放在圆括号中链接地址后面，跟链接地址之间以空格分隔，“”里写描述文字

×网址和Email

使用尖括号可以很方便地把URL或者email地址变成可点击的链接。

带格式化的链接

强调 链接, 在链接语法前后增加两个*星号。 要将链接表示为代码，请在方括号中添加反引号

[链接](地址) 靶场

图片

要添加图像，请使用感叹号 (!), 然后在方括号增加替代文本，图片链接放在圆括号里，括号里的链接后可以增加一个可选的图片标题文本。

插入图片Markdown语法代码：![图片名alt](图片链接/地址 "图片title")

链接图片

给图片增加链接，请将图像的Markdown 括在方括号中，然后将链接添加在圆括号中

[![沙漠中的岩石图片](/assets/img/shiprock.jpg "Shiprock")](https://markdown.com.cn)

转义字符

* 要显示原本用于格式化 Markdown 文档的字符，请在字符前面添加反斜杠字符 \ 。

内嵌HTML标签

对于 Markdown 涵盖范围之外的标签，都可以直接在文件里面用 HTML 本身。如需使用 HTML，不需要额外标注这是 HTML 或是 Markdown，只需 HTML 标签添加到 Markdown 文本中即可

行级內联标签

HTML 的行级內联标签如 <span>、<cite>、<del> 不受限制，可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯，甚至可以不用 Markdown 格式，而采用 HTML 标签来格式化。例如：如果比较喜欢 HTML 的 <a> 或 <img> 标签，可以直接使用这些标签，而不用 Markdown 提供的链接或是图片语法。当你需要更改元素的属性时（例如为文本指定颜色或更改图像的宽度），使用 HTML 标签更方便些。

HTML 行级內联标签和区块标签不同，在內联标签的范围内， Markdown 的语法是可以解析的。

This **word** is bold. This <em>word</em> is italic.

渲染效果如下:

This word is bold. This word is italic.

区块标签

区块元素──比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行，以便于内容区分。而且这些元素的开始与结尾标签，不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素，避免在区块标签前后加上没有必要的 <p> 标签。

例如，在 Markdown 文件里加上一段 HTML 表格：

This is a regular paragraph.

<table>
    <tr>
        <td>Foo</td>
    </tr>
</table>

This is another regular paragraph.

请注意，Markdown 语法在 HTML 区块标签中将不会被进行处理。例如，你无法在 HTML 区块内使用 Markdown 形式的*强调*。

HTML 用法最佳实践

出于安全原因，并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问，请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。

对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>，请在其前后使用空行（blank lines）与其它内容进行分隔。尽量不要使用制表符（tabs）或空格（spaces）对 HTML 标签做缩进，否则将影响格式。

在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

← 返回文章列表