Markdwon拓展语法指南

Markdown拓展语法指南

Markdown的语法分为基本语法与拓展语法两大部分，本文介绍的为拓展语法(GFM)

---

目录

• Markdown拓展语法指南
  • 目录
  • 删除线
  • Emoji
  • 自动连接
  • 表格
    • 对齐
  • 围栏代码块
    • 代码块转义
  • 任务列表
  • 锚点
  • 参考

---

删除线

用双波浪线包裹需要添加删除线的单词，中间不可有空格

~~错误~~

渲染效果如下:
错误

---

Emoji

使用冒号包裹表情代码来插入emoji表情

:smile:

渲染效果如下：
😄
表情符号简码列表

---

自动连接

在标准语法中，需要使用<>来包裹url，但在拓展语法中，url可以被自动解析，不需要加额外符号。

https://www.cnblogs.com/DuckingWJ

渲染效果如下：

https://www.cnblogs.com/DuckingWJ

如果不想使用自动链接，可以使用反引号包裹来取消自动链接

`https://www.cnblogs.com/DuckingWJ`

渲染效果如下：

https://www.cnblogs.com/DuckingWJ

---

表格

要添加表，请使用三个或多个连字符（---）创建每列的标题，并使用管道（|）分隔每列。您可以选择在表的任一端添加管道。

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

渲染效果如下：

Syntax	Description
Header	Title
Paragraph	Text

使用连字符和管道创建表可能很麻烦。为了加快该过程，请尝试使用Markdown Tables Generator。使用图形界面构建表，然后将生成的Markdown格式的文本复制到文件中。

对齐

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

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

渲染效果如下：

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

---

围栏代码块

使用三个连续的反引号包裹你的代码块,并且，在第一个代码块旁可以标记代码语言实现代码高亮

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

渲染效果如下：

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

代码块转义

想要在代码块中显示反引号，转用四个反引号包裹代码即可正常显示反引号

---

任务列表

任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中，复选框将显示在内容旁边。要创建任务列表，请在任务列表项之前添加破折号-和方括号[ ]，并在[ ]前面加上空格。要选择一个复选框，请在方括号[x]之间添加 x 。

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

渲染效果如下：

• Write the press release
• Update the website
• Contact the media

---

锚点

使用锚点可以标记文档标题，点击即可实现跳转，常用于目录。
[描点名称](#锚点链接)

目录

* [第一章](#删除线)

渲染效果如下：
目录

• 第一章

---

参考

Markdown官方文档
《了不起的Markdwon》 毕小鹏 电子工业出版社