Skip to content

#扩展语法

基于基本 Markdown 语法的进阶功能。

概述

原始 Markdown 设计文档中概述的 基本语法 添加了许多日常所需元素,但对某些人来说还不够。这就是扩展语法发挥作用的地方。

一些个人和组织通过添加表格、代码块、语法高亮、URL 自动链接和脚注等其他元素,自行扩展了基本语法。这些元素可以通过使用基于基本 Markdown 语法的轻量级标记语言或向兼容的 Markdown 处理器添加扩展来启用。

可用性

并非所有 Markdown 应用程序都支持扩展语法元素。您需要检查应用程序使用的轻量级标记语言是否支持您想要使用的扩展语法元素。如果不支持,您仍然可以在 Markdown 处理器中启用扩展。

轻量级标记语言

有几种轻量级标记语言是 Markdown 的超集。它们包含基本语法,并通过添加表格、代码块、语法高亮、URL 自动链接和脚注等其他元素对其进行扩展。许多最流行的 Markdown 应用程序都使用以下轻量级标记语言之一

Markdown 处理器

有 数十个 Markdown 处理器 可用。其中许多允许您添加启用扩展语法元素的扩展。有关更多信息,请查看处理器的文档。

表格

要添加表格,请使用三个或更多连字符 (---) 创建每个列的标题,并使用竖线 (|) 分隔每个列。为了兼容性,您还应该在行的两端添加一个竖线。

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

呈现的输出如下所示

SyntaxDescription
HeaderTitle
ParagraphText

提示

使用连字符和管道创建表格可能很繁琐。要加快这一过程,请尝试使用 Markdown 表格生成器 或 AnyWayData Markdown 导出。使用图形界面构建表格,然后将生成的 Markdown 格式文本复制到文件中。

对齐

可以通过在标题行的连字符左侧、右侧或两侧添加冒号 (:) 将列中的文本左对齐、右对齐或居中对齐。

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

呈现的输出如下所示

语法说明测试文本
标题标题这是
段落文本还有更多

表格中的文本格式设置

可以设置表格中的文本格式。例如,可以添加 链接、代码(仅限反引号 ``` 中的单词或短语,不包括 代码块)和 强调。

不能使用标题、引用块、列表、水平线、图像或大多数 HTML 标记。

提示

可以使用 HTML 在表格单元格中创建 换行符 和添加 列表。

转义表格中的管道字符

可以通过使用其 HTML 字符代码 (|) 在表格中显示管道 (|) 字符。

围栏式代码块

基本的 Markdown 语法允许通过将行缩进四个空格或一个制表符来创建 代码块。如果你觉得不方便,请尝试使用围栏式代码块。根据你的 Markdown 处理器或编辑器,你将在代码块之前和之后的行上使用三个反引号 (```) 或三个波浪号 (~~~)。最棒的是什么?你不必缩进任何行!

INFO


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

呈现的输出如下所示

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

更新中...

Released under the MIT License.