Markdown语法

发布时间 2023-11-09 15:34:46作者: zero_4046

Markdown

标题语法

(#)号数量表示标题的等级,例:

# 一级标题
## 二级标题

强调语法

通过将文本设置为粗体或斜体来强调其重要性。

粗体

要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或下划线(underscores)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)。

添加星号:
**加粗**
添加下划线:
__加粗__

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

斜体

要用斜体显示文本,请在单词或短语前后添加一个星号(asterisk)或下划线(underscore)。要斜体突出单词的中间部分,请在字母前后各添加一个星号,中间不要带空格。

添加星号:
*斜体*
添加下划线:
_斜体_

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

Markdown 应用程序在处理单词或短语中间添加的下划线上并不一致。为了实现兼容性,请使用星号将单词或短语的中间部分加粗并以斜体显示,以示重要。

引用语法

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

> 引用

引用

多个段落的块引用

>引用
>
>引用

引用

引用

嵌套块引用

>引用
>
>>引用

引用

引用

带有其它元素的块引用

> #### 引用
>
> - 引用
> - 引用
>
>  *斜体* 引用 **粗体**.

引用

  • 引用
  • 引用

斜体 引用 粗体.

列表语法

有序列表

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

1. First item
2. Second item
3. Third item
4. Fourth item

1. First item
1. Second item
1. Third item
1. Fourth item

1. First item
8. Second item
3. Third item
5. Fourth item

1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item

上面代码效果相同,同时可嵌套使用。

  1. First item
  2. Second item
  3. Third item
    1. Indented item
    2. Indented item
  4. Fourth item

无序列表

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

- First item
- Second item
- Third item
- Fourth item

* First item
* Second item
* Third item
* Fourth item

+ First item
+ Second item
+ Third item
+ Fourth item

- First item
- Second item
- Third item
    - Indented item
    - Indented item
- Fourth item
  • First item
  • Second item
  • Third item
    • Indented item
    • Indented item
  • Fourth item

在列表中嵌套其他元素

要在保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符,如下例所示:

*   This is the first list item.
*   Here's the second list item.

    I need to add another paragraph below the second list item.

*   And here's the third list item.
  • This is the first list item.

  • Here's the second list item.

    I need to add another paragraph below the second list item.

  • And here's the third list item.

代码块

代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进八个空格或两个制表符

1.  Open the file.
2.  Find the following code block on line 21:

        <html>
          <head>
            <title>Test</title>
          </head>

3.  Update the title to match the name of your website.
  1. Open the file.

  2. Find the following code block on line 21:

    <html>
      <head>
        <title>Test</title>
      </head>
    
  3. Update the title to match the name of your website.

代码语法

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

`代码`

代码

转义反引号

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

``转义`代码`反引号``

转义`代码`反引号

分隔线语法

要创建分隔线,请在单独一行上使用**三个或多个星号 (***)、破折号 (---) 或下划线 (___) **,并且不能包含其他内容。(为了兼容性,请在分隔线的前后均添加空白行。)

***

---

_________________



链接语法

不同的 Markdown 应用程序处理URL中间的空格方式不一样。为了兼容性,请尽量使用%20代替空格

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

超链接Markdown语法代码:

[超链接显示名](超链接地址 "超链接title")

超链接显示名

给链接增加 Title

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

网址和Email地址

<网址>
<Email地址>

带格式化的链接

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

强调链接
**[超链接显示名](超链接地址 "超链接title")**

超链接显示名

将链接表示为代码
`[超链接显示名](超链接地址 "超链接title")`

[超链接显示名](超链接地址 "超链接title")

引用类型链接

[1]: 网址
[文本][1]

文本

图片语法

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

![文本](图片位置 "图片title")

文本

链接图片

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

[![文本](图片位置 "图片title")](链接)

文本

转义字符语法

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

\*转义无序列表

*转义无序列表

可做转义的字符

以下列出的字符都可以通过使用反斜杠字符从而达到转义目的。

  • \
  • `
  • _
  • {}
  • []
  • ()
  • .
  • !
  • |

内嵌 HTML 标签

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

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

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

段落

<table>
    <tr>
        <td>表格</td>
    </tr>
</table>

段落

段落

表格

段落

在 HTML 块级标签内不能使用 Markdown 语法。

<p>**加粗**</p>

**加粗**

以上就是所有常见的Markdown语法!