2025年 07月26日 00:00 星期六
1898 字 · 8 分钟

Markdown基本语法

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。

Markdown标题语法

要创建标题请在单词或者文字前面加 #,其数量代表了标题的级别,共有6个级别。

标题1

标题2

标题3

MARKDOWN
# 标题1
## 标题2
### 标题3
...
HTML
<h1>标题1</h1>    
<h2>标题2</h2>
<h3>标题3</h3>

不同的 Markdown 应用程序处理 # 和标题之间的空格方式并不一致。为了兼容考虑,请用一个空格在 # 和标题之间进行分隔。

Markdown段落语法

要创建段落,请使用空白行将一行或多行文本进行分隔。

我真的喜欢Markdown

Markdown是我的最爱

MARKDOWN
我真的喜欢Markdown

Markdown是我的最爱
HTML
<p>我真的喜欢Markdown</p>
<p>Markdown是我的最爱</p>

不要用空格(spaces)或制表符( tabs)缩进段落。

Markdown 强调语法

粗体

要加粗文本,请在单词或文字的前后各添加两个星号或下划线。

我是粗体

MARKDOWN
我是**粗体**
我是__粗体__
HTML
我是<strong>粗体</strong>

Markdown 应用程序在如何处理单词或文字中间的下划线上并不一致。为兼容考虑,在单词或文字中间部分加粗的话,请使用星号。

斜体

要用斜体显示文本,请在单词或文字的前后各添加一个星号或下划线。

我是斜体

MARKDOWN
我是*斜体*
我是_斜体_
HTML
我是<em>斜体</em>

粗体和斜体

要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。

我是粗斜体

MARKDOWN
我是***粗斜体***
我是___粗斜体___
HTML
我是<strong><em>粗斜体</em></strong>

要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分,请在要突出显示的部分前后各添加三个星号,中间不要带空格。

Markdown 引用语法

要创建块引用,请在段落前添加一个 > 符号。

这是块引用

MARKDOWN
> 这是块引用

块引用1

块引用2

块引用3

块引用4

块引用5

MARKDOWN
> 块引用1
>> 块引用2
>>> 块引用3
>> 块引用4
> 块引用5

块引用可以包含其他 Markdown 格式的元素。

标题1

粗体

  • 列表1
MARKDOWN
> # 标题1
> 
> *粗体*
> 
> - 列表1
>

Markdown列表语法

可以将多个条目组织成有序或无序列表,并且列表可以进行嵌套。

  1. 第一条

    1. 内部条
  2. 第二条

  3. 第三条

MARKDOWN
1. 第一条
  1. 内部条    
2. 第二条 
3. 第三条
HTML
<ol>
<li>第一条</li>
<ol><li>内部条</li></ol>
<li>第二条</li> 
<li>第三条</li>
</ol>

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

  • 第一条

    • 第二条

      • 第三条
MARKDOWN
- 第一条
  - 第二条
    - 第三条
HTML
<ul>
<li>第一条</li>
<ul><li>第二条</li> </ul>
<ul><li>第三条</li></ul>
</ul>

为了兼容性,请不要在同一列表中使用不同的分隔符。

Markdown 代码语法

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

这是一段代码

MARKDOWN
`这是一段代码`
HTML
<code>这是一段代码</code>

如果你要表示为代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在双反引号(``)中。

这是一段含有反引号`的代码

MARKDOWN
``这是一段代码``
HTML
<code>这是一段含有反引号`代码</code>

如果你想表示固定某种编程语言或者标记语言等的代码,可以使用三个引号来表示。例如表示python语法:

PYTHON
print("Hello World!")
MARKDOWN
```python
print("Hello World!")

Markdown 分隔线语法

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


MARKDOWN
---
***

为了兼容性,请在分隔线的前后均添加空白行。

Markdown 链接语法

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

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

百度

MARKDOWN
[百度](www.baidu.com "百度一下")
HTML
<a href="www.baidu.com" title="百度一下">百度</a>

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

<www.baidu.com>

123@163.com

MARKDOWN
<www.baidu.com>
<123@163.com>

带格式化的链接

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

百度

百度

百度

MARKDOWN
**[百度](www.baidu.com "百度一下")**
*[百度](www.baidu.com "百度一下")*
[`百度`](www.baidu.com "百度一下")

引用类型链接

引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。参考样式链接分为两部分:与文本保持内联的部分以及存储在文件中其他位置的部分,以使文本易于阅读。

[引用] 1

链接的第一部分格式

引用类型的链接的第一部分使用两组括号进行格式设置。第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向您存储在文档其他位置的链接。

尽管不是必需的,可以在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。

以下示例格式对于链接的第一部分效果相同:

  • [引用][1]
  • [引用] [1]

链接的第二部分格式

引用类型链接的第二部分使用以下属性设置格式:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]:)。
  2. 链接的URL,可以选择将其括在尖括号中。
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中。

以下示例格式对于链接的第二部分效果相同:

  • [1]: www.baidu.com

  • [1]: www.baidu.com "百度一下"

  • [1]: www.baidu.com '百度一下'

  • [1]: www.baidu.com (百度一下)

  • [1]: <www.baidu.com> "百度一下"

  • [1]: <www.baidu.com> '百度一下'

  • [1]: <www.baidu.com> (百度一下)

可以将链接的第二部分放在Markdown文档中的任何位置。有些人将它们放在出现的段落之后,有些人则将它们放在文档的末尾(例如尾注或脚注)。

Markdown 图片语法

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

图片错误(www.baidu.com)

MARKDOWN
![图片错误](/image/image2.jpg "图片title")(www.baidu.com)
HTML
<img src="/image/image2.jpg" alt="图片错误" title="图片title">

Markdown 转义字符语法

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

*我不是斜体*

MARKDOWN
\*我不是斜体\*

Thanks for reading!

Markdown常见用法

2025年 07月26日 00:00 星期六
1898 字 · 8 分钟