Skip to content

Markdown基础语法

1. 标题

Markdown 使用 # 来表示标题。根据 # 的数量,决定标题的级别

markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 段落和换行

普通文本之间空一行即可创建段落。换行使用两个空格后按 Enter

markdown
这是第一段文本。

这是第二段文本。

这是第三段文本,  
它是紧接着上一段换行的。

这是第一段文本。

这是第二段文本。

这是第三段文本,
它是紧接着上一段换行的。

3. 强调

通过 *_ 来表示斜体和粗体

  • 斜体:使用单个星号 * 或单个下划线 _
  • 粗体:使用两个星号 ** 或两个下划线 __
  • 斜体和粗体:使用三个星号 *** 或三个下划线 ___
markdown
*斜体*
_斜体_

**粗体**
__粗体__

***斜体和粗体***
___斜体和粗体___

斜体斜体

粗体粗体

斜体和粗体斜体和粗体

4. 列表

  • 无序列表

    无序列表使用 -+* 作为列表项标记。

markdown
- 项目一
+ 项目二
* 项目三
  • 有序列表

    有序列表使用数字和点号(1.)表示

markdown
1. 第一项
2. 第二项
3. 第三项
  • 嵌套列表

    通过在子列表前添加空格或制表符来创建嵌套列表

markdown
1. 第一项
   - 子项 1
   - 子项 2
2. 第二项
  1. 第一项
    • 子项 1
    • 子项 2
  2. 第二项

5. 链接

Markdown 支持两种方式来插入链接:

  • 行内式链接:[链接文本](URL)
markdown
[百度](https://www.baidu.com)

百度

  • 引用式链接:[链接文本][1][1]: URL
markdown
[百度][1]
[1]: https://www.baidu.com

百度

  • 给链接增加 Title

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

markdown
[百度](https://www.baidu.com "百度一下,你就知道")

百度

  • 禁用自动URL链接

    如果您不希望自动链接URL,则可以通过将URL表示为带反引号的代码来删除该链接

markdown
`http://www.baidu.com`

http://www.baidu.com

6. 图片

插入图片和链接的语法类似,区别在于图片前面有一个感叹号 !,括号里的链接后可以增加一个可选的图片标题文本

markdown
![图片描述](图片URL" 图片title")
  • 链接图片

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

markdown
[![岩石图片](../img/shiprock.jpg "Shiprock")](https://xxxx.cn)

7. 引用

引用使用 > 来标识

markdown
> 这是一个引用。

多级引用可以通过嵌套 > 来实现。

markdown
> 一级引用
>> 二级引用

8. 代码

  • 行内代码

    使用反引号 ` 来包裹行内代码

markdown
这是 `行内代码` 示例。
  • 要将链接表示为代码,请在方括号中添加反引号
markdown
I love supporting the **[EFF](https://eff.org)**.  
This is the *[baidu](https://www.baidu.com)*.  
See the section on [`code`](#code).

I love supporting the EFF.
This is the baidu.
See the section on code.

  • 块级代码

    使用三个反引号 (```) 或者三个波浪号(~~~)来表示代码块,可以指定语言类型来启用语法高亮

python
def hello():
    print("Hello, Markdown!")

9. 水平分割线

水平线使用三个或更多的星号(***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容

markdown
***
---
_________

10. 表格

Markdown 也支持表格,表头和表体之间用 |- 进行分隔,如使用三个或多个连字符(---)创建每列的标题,并使用管道(|)分隔每列

markdown
| 表头1 | 表头2 | 表头3 |
| ----- | ----- | ----- |
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |
SyntaxDescription
HeaderTitle
ParagraphText
  • 对齐

    通过在标题行中的连字符的左侧,右侧或两侧添加冒号(:),将列中的文本对齐到左侧,右侧或中心

markdown
| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this   |
| Paragraph   | Text        | And more      |
SyntaxDescriptionTest Text
HeaderTitleHere's this
ParagraphTextAnd more

11. 特殊字符

如果你需要插入特殊字符(如 #* 等)而不被解释为 Markdown 语法,可以使用反斜杠 \ 来转义

markdown
\# 这是一个井号
\* 这是一个星号

12. 自定义链接锚点

在 Markdown 中,你可以为标题添加自定义锚点,然后在文档内创建链接

markdown
## 章节标题 {#custom-id}

[跳转到自定义标题](#custom-id)

13. 任务列表

任务列表用于表示待办事项。每一项任务使用 [ ][x]来表示未完成和已完成任务

markdown
- [ ] 任务1
- [x] 任务2
- [ ] 任务3
  • 任务1
  • 任务2
  • 任务3

14. 表情符号

Markdown 中可以通过使用 :emoji_name: 来插入表情符号

markdown
:smile: :heart: :thumbsup:
真好笑! :joy:

15.删除线

若要删除词语,请在词语前后使用两个波浪号(~~)

markdown
~~世界是平坦的。~~ 我们现在知道世界是圆的。

世界是平坦的。 我们现在知道世界是圆的。

最近更新