Markdown使用方法

Markdown

Markdown 是一种轻量级的标记语言，可用于在纯文本文档中添加格式化元素。Markdown 由 John Gruber 于 2004 年创建，如今已成为世界上最受欢迎的标记语言之一。

1.斜体和加粗

1.1斜体

使用下划线 (_ )或者(*) 包裹文本，即可变成斜体。例如， _这个_ 词将会变成斜体

斜体斜体

1.2 粗体

使用双星号(**)或者双下划线（__）包裹文本，即可变成粗体。例如，**这个**词将会变成粗体

粗体

对于粗体和斜体，一般都是采用*或者**。

2.标题

在Markdown里面添加标题，你要在文本的前面添加一个井号 (#)。你可以键入多个井号来生成你想要的几级标题。例如，一级标题你需要添加一个井号 (# 一级标题)，当你需要一个三级标题时你就要三个#号 (### 三级标题)。

3.超链接

在 Markdown 中有两种不同的链接种类，但是它们的渲染方式完全相同。第一种链接格式叫做 内联链接。创建一个内联的链接，你需要将被链接的文本用方括号 ( [ ] )包裹起来，然后将链接地址用圆括号 ( ( ) )包裹起来。

例如创建一个写着 “Visit Github!” 到 www.github.com 的超链接，你应该使用Markdown这样书写： [Visit GitHub!](www.github.com)

Visit GitHub!

4.图片

如果你知道怎样使用 Markdown 添加链接，那么你也可以添加图片了。添加图片的语法和添加链接的非常相似。

添加图片也有两种方法，就像链接一样，并且渲染出来的结果是一样的。添加链接和图片的区别仅仅在于前面的感叹号 ( ! )。

第一种图片的格式叫做 内联图片链接。创建一个内联的图片链接，需要输入一个感叹号 ( ! )将方括号 ( [ ] )中的描述性文本包裹起来，然后使用圆括号 ( ( ))包裹链接地址。

例如创建一个描述文本为"Benjamin Bannekat"的内联的链接地址为 https://octodex.github.com/images/bannekat.png 的图片，你应该这样写Markdown： ![Benjamin Bannekat](https://octodex.github.com/images/bannekat.png)

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eyHCLNxn-1645869262389)(C:\Users\ASUS\Desktop\前端学习\roadmap-完整路线.jpeg)]

5.引用块

如果需要为其他来源的内容添加特殊的格式来引起读者的注意，或为其他杂志的文章设计特殊的格式，那么 Markdown 的引用块语法将会非常有用。引用块是一个拥有特殊格式的句子或段落，为了引起读者的注意。例如：

要创建一个引用块，您只需要在行首添加大于号（>）。例如：

> “无为而治的罪是所有七种罪中最致命的。有传言说，要使邪恶的人实现其目的，只需要好人无所事事。”

如果需要嵌套引用的话，可以在要嵌套的段落前添加一个 >> 符号。例如：

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

6.列表

6.1 无序列表

要创建一个无序列表，你需要在每一个列表项前加一个破折号 (-)、星号 (*) 或加号 (+) 。每个列表要占一行。例如，一个杂货店商品的列表可以用 Markdown 写成这样：

* 牛奶
* 鸡蛋
* 三文鱼
* 黄油

这个 Markdown 列表将会显示成这样：

牛奶
鸡蛋
三文鱼
黄油

6.2 有序列表

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

例如：

First item
Second item
Third item
Fourth item

如果你需要以数字开头并且紧跟一个英文句号（也就是 .）的无序列表项，则可以使使用反斜线（\）来转义这个英文句号。

例如输入：

- 1968\. A great year!
- I think 1969 was second best.

这个 Markdown 列表将会显示成这样：

1968. A great year!
I think 1969 was second best.

7. 段落

Markdown 有多种不同的方法定义段落。

可以通过在每一行的结尾输入俩个空格来实现段落定义，空格是不可见的。
例如

是段落换行，诗歌需要的是段落间换行。你可以通过在每一行的结尾输入俩个空格来实现这一点。空格是不可见的，输入的内容就像这样：

我有自相矛盾么？··
很好，那我是在自相矛盾了，··
（我是庞大的，我承载着很多个自己。）

每个点（ · ）都代表一个空格。

8.代码

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

例如：At the command prompt, type `nano`.

在Markdown中显示为这样：

At the command prompt, type nano.

9.代码块

要创建代码块，需要将代码块的每一行缩进至少四个空格或一个制表符。

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

如果觉得不方便，可以试试围栏代码块（fenced code blocks）。根据 Markdown 解析器或编辑器的不同，代码块的前后可以使用三个反引号（`````）或三个波浪号（~~~）来标记围栏代码块。

如需添加语法高亮，可以在围栏代码块前的反引号旁指定所用的编程语言。

10.链接

要创建链接，请将链接文本括在方括号（例如 [Duck Duck Go]）中，后面紧跟着括在圆括号中的 URL（例如 (https://duckduckgo.com) ）。

My favorite search engine is [Duck Duck Go](https://duckduckgo.com).

渲染效果如下：

My favorite search engine is Duck Duck Go.

11.分隔线

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

12.删除线

可以通过在单词前面和后面分别放置两个波浪号（~~）来表示删除这些单词。

例如：~~The world is flat.~~ We now know that the world is round.

渲染效果如下所示：

~~The world is flat.~~ We now know that the world is round.

13.添加标题

你可以选择为链接添加标题（即 title 属性）。当用户将鼠标悬停在链接上时，将显示一个提示。要添加标题，请将其放在 URL 后面。

My favorite search engine is [Duck Duck Go](https://duckduckgo.com "The best search engine for privacy").

渲染效果如下：

My favorite search engine is Duck Duck Go.

14.自定义标题的ID

通过添加自定义 ID，能够让你直接链接到这个标题，并且还能使用 CSS 修改其样式。如需为标题添加自定义 ID，需要将自定义 ID 用花括号括起来并与标题一起放在同一行。

例如：

### My Great Heading {#heading-ids}

渲染后：

My Great Heading {#heading-ids}

此外，可以在文档中创建一个标准链接，其后是井号（#）和自定义的标题 ID ，从而链接到这个标题。

例如：[Heading IDs](#heading-ids)

Heading IDs

其它网站也可以通过将自定义的标题 ID 添加到网页的完整的 URL 后面来链接到对应的标题（例如，[Heading IDs](https://www.markdown.xyz/extended-syntax#heading-ids)）。

15.任务列表

可以通过在任务列表项前面添加破折号（-）和中间带空格的方括号（[ ]），来创建任务列表。要选中复选框，请在方括号中间添加一个 x ，即（[x]）。

例如：

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

渲染效果如下：

Write the press release
Update the website
Contact the media

16.高亮

最新版本的Markdown还支持高亮功能。

可以使用(==)包裹词组的方式，实现词组高亮。
例如：`I need to highlight these very important words.

17.禁止自动将 URL 转换为链接

许多 Markdown 解析器会自动将 URL 转换为链接，如果你输入 http://www.github.com，你的 Markdown 解析器也会自动将其转换为链接。通过反引号能够将URL表示为代码。

18.表格

如需添加表格，可使用三个或更多个连字符（---）来为每个列创建表头，并使用管道符（|）来分隔每个列。为兼容考虑，应该在行的两侧添加管道符。

例如：

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

渲染效果如下：

Syntax	Description
Header	Title
Paragraph	Text

18.1 对齐

通过在标题行中的连字符（hyphens）的左侧或右侧或两侧添加冒号（:），可以将对应列中的文本向左或向右或居中对齐。

例如：

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

渲染效果如下：

Syntax	Description	Test Text
Header	Title	Here’s this
—	:----:	—:
Header	Title	Here’s this
Paragraph	Text	And more


渲染效果如下：

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