Markdown 基本语法

最新推荐文章于 2024-07-29 23:56:34 发布

qq_40928164

最新推荐文章于 2024-07-29 23:56:34 发布

阅读量194

点赞数

文章标签：大数据 html 前端

本文链接：https://blog.csdn.net/qq_40928164/article/details/125634834

版权

本文详细介绍了Markdown的基本语法，包括标题、段落、换行、强调、引用、列表、代码块、表格、扩展特性等，并展示了如何创建表格、代码块和使用链接。通过实例演示，让读者快速上手Markdown，提升文档编辑效率。

摘要由CSDN通过智能技术生成

Markdown 基本语法

一、基本语法 {#jiChuYuFa}

1. 标题语法

使用多少个#开头表示几级标题。如：####表示二级标题。
使用===或–进行分割分别表示一二级标题。

2. 段落语法

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

3. 换行语法

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

4. 强调语法

可选符号有*和_。推荐使用*
使用单符号括起来表示斜体，使用双符号括起来表示粗体，使用三符号括起来表示粗斜体。
删除线: 在要绘制删除线的左右两位置使用~~。例如：~~删除~~：删除
下划线: 在要绘制下划线的左右使用under标签。例如：<u>下划线</u>例如：下划线

5. 引用语法

多个段落的块引用使用>符号。如：

多个段落的块引用

块引用可以嵌套。在要嵌套的段落前再添加一个 > 符号，有几层就有几个>。如：

第一个块

第二个块

第三个块

6. 列表语法

可以使用的符号有* 、- 、+ 、1. 、1）。
推荐使用* 和1. 。
列表在进行嵌套时，通过四个空格进行缩进。
列表和块可以相互嵌套。如：

第一个块

列表一
二级列表

列表一

第一个块

7. 代码语法

要将单词或短语表示为代码，请将其包裹在反引号 (`) 中。
要创建代码块，需要将代码块的每一行缩进至少四个空格或一个制表符。

8. 分隔线语法

在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ，并且不能包含其他内容。推荐使用（*）

9. 链接语法

[链接名称](链接地址 title)  例如：[百度](https://www.baidu.com '百度官网')

百度

二、扩展语法

####1. 表格

使用三个或多个连字符（—）创建每列的标题，并使用管道（|）分隔每列。根据:在所咋列的—位置设置对齐方式。例如：| :— | :—: | —: | 分别是左对齐，居中对齐和右对齐。

例如：

| Syntax      | Description | Test Text     |
| :---        |    :----:   |          ---: |
| Header      | Title       | Here's this hhhhhh  |
| Paragraph   | Text        | And more      |

输出效果：

Syntax Description Test Text
Header Title Here’s this hhhhhh
Paragraph Text And more

Syntax	Description	Test Text
Header	Title	Here’s this hhhhhh
Paragraph	Text	And more

您可以在表格中设置文本格式。例如，您可以添加链接，代码（仅反引号（`）中的单词或短语，而不是代码块）和强调。

例如：

| Syntax      | Description | Test Text        |
| :---        |    :----:   |          ---:    |
| [Header](https://www.baidu.com)    | `Title ddd`      | **Here's this hhhhhh** |
| Paragraph   | Text        | And more      |

输出效果：

Syntax Description Test Text
Header Title ddd Here’s this hhhhhh
Paragraph Text And more

Syntax	Description	Test Text
Header	`Title ddd`	Here’s this hhhhhh
Paragraph	Text	And more

2. 围栏代码块

代码块之前和之后的行上使用三个反引号（(```）或三个波浪号（~~~）。

例如：

```
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

输出效果：

{
 "firstName": "John",
 "lastName": "Smith",
 "age": 25
}

语法高亮: 在受防护的代码块之前的反引号旁边指定一种语言。

例如：

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

输出效果

{
 "firstName": "John",
 "lastName": "Smith",
 "age": 25
}

####3. 脚注

带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。

例如：

Here's a simple footnote,[^1]
[^1]: This is the first footnote.

输出效果：

Here’s a simple footnote,¹

####4. 标题编号

通过创建带有数字符号（#）和自定义标题ID的[自定义标题](#ziDingYi)，可以链接到文件中具有自定义ID的标题。

例如：

[去基础语法标题](#jiChuYuFa)
### 基础语法 {#jiChuYuFa}

输出效果：

去基础语法标题

5. 定义列表

例如：

First Term
: This is the definition of the first term.

输出效果：

First Term

This is the definition of the first term.

6. 任务列表语法

创建带有复选框的项目列表。表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。要选择一个复选框，请在方括号[x]之间添加 x 。

例如：

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

输出效果：

Write the press release
Update the website
Contact the media

####7. 使用Emoji表情

有两种方法可以将表情符号添加到Markdown文件中：将表情符号复制并粘贴到Markdown格式的文本中，或者键入emoji shortcodes。

例如：

:joy:
:tent:

输出效果：
😂
⛺️

####8. 自动网址链接

许多Markdown处理器会自动将URL转换为链接。
例如：http://www.example.com: 显示为：http://www.example.com
如果您不希望自动链接URL，则可以通过将URL表示为带反引号的代码来删除该链接。例如：`http://www.example.com`,显示为：http://www.example.com