Markdown 基础语法

Markdown 是一种简单、易用的标记语言,它几乎可以格式化任何文本。

标题

使用标题符号 # 可以创建 1~6 级标题。 例如:

# 标题等级 1
...
###### 标题等级 6

注意: 标题符号 # 与标题文本之间有一个空格。

也可以使用 =- 创建 1、2 级标题。 例如:

标题等级 1
===
标题等级 2
---

换行

在行尾使用两个空格进行换行。 例如:

文本行 1,行尾使用了两个空格。  
文本行 2...

段落

使用空行可以形成段落。 例如:

段落 1,下面是空行。

段落 2,上面是空行。

分割线

在单独一行上连续使用三个 *- 或者 _ 符号都可以创建分割线。 例如:

*** 分割线 1
--- 分割线 2
___ 分割线 3

斜体

要显示斜体文字,只需在文本前、后各输入一个 * 或者 _ 符号。 例如:

*斜体文字*
_斜体文字_

注意: 符号 * 或者符号 _ 与斜体文本之间没有空格。

粗体

要显示粗体文本,只需在文本前、后各输入两个 * 或者 _ 符号。 例如:

**粗体文本**
__粗体文本__

注意: 符号 * 或者符号 _ 与粗体文本之间没有空格。

粗斜体

要显示粗斜体,只需在文本前、后各输入三个 * 或者 _ 符号。 例如:

***粗斜体文本***
___粗斜体文本___

注意: 符号 * 或者符号 _ 与粗斜体文本之间没有空格。

块引用

使用符号 > 可以创建块引用(Blockquote)。 例如:

> 块引用 1
> 块引用 2

块引用可以嵌套,也可以包含其它 Markdown 元素,例如加粗效果等,具体可以添加的元素因解析器的差异而有所不同,请留意其说明。

注意: 块引用符号 > 与文本之间有一个空格。

有序列表

使用 数字 + . 可以创建有序列表。 例如:

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

注意: 有序列表必须以数字开头。
另外,有序列表可以通过 Tab 键来增加层级关系,通过 Shift + Tab 组合键来减少层级关系。

无序列表

使用 *-+ 符号中的任何一个都可以创建无序列表。 例如:

* 无序列表 1
+ 无序列表 2
- 无序列表 3

注意: 无序列表可以通过 Tab 键来增加层级关系,通过 Shift + Tab 组合键来减少层级关系。

代码

使用一对反引号 ` 包含代码可以凸显代码文本。 例如:

这段文本中包含 `markdown` 元素。

注意: 反引号可以嵌套使用。

代码块

使用四个空格或者 Tab 键缩进文本可以创建代码块。 例如:

    <html>
        <head>
        </head>
    </html>

注意: 另一种创建代码块的方式,请参考扩展语法中的相关介绍。

网址和邮件地址

将网址或邮件地址放入一对 <> 中,即可快速转换为链接。 例如:

<http://markdown.com/>
<test@example.com>

链接

把文本放在 [] 中,URL 放在 () 中,即可创建文本链接。 例如:

推荐使用[百度](https://www.baidu.com)查找资料。

还可以在 URL 后面输入信息,为链接文本添加工具提示。 例如:

推荐使用[百度](https://www.baidu.com "搜索引擎")查找资料。

注意: 方括号和圆括号之间没有空格。

引用链接

通过引用自定义标签处提供的 URL 创建链接。 例如:

推荐使用[百度][baidu]查找资料。

...

[baidu]: https://www.baidu.com "搜索引擎"

注意: 自定义的标签可以放在任何位置,推荐放在文档最后,方便统一管理。

图片

链接 前面加入感叹号 ! 即可插入图片。 例如:

![服装设计](./1.jpg "这是一款女童时装")

如果在图像后面添加一个 URL 即可实现图片链接。 例如:

[![百度](./baidu.jpg "搜索引擎")](https://www.baidu.com)

注意: 图片地址可以使用绝对路径或者相对路径。

转义字符

可以使用反斜杠 \ 转义以下 Markdown 字符:

序号 字符 名称
1 \ 反斜杠
2 ` 反引号
3 * 星号
4 _ 下划线
5 {} 大括号
6 [] 中括号
7 () 小括号
8 # 井号
9 + 加号
10 - 减号(连字符)
11 .
12 感叹号
13 | 管道符
 posted on 2024-10-18 19:23  码老白  阅读(6)  评论(0编辑  收藏  举报