Grav - Markdown 语法

Markdown 语法定义为以易于阅读和易于编写的方式编写纯文本，随后将其转换为 HTML 代码。Markdown 语法中使用诸如 (*) 或 (`) 之类的符号。这些符号用于加粗、创建标题和组织内容。

要使用 Markdown 语法，您必须在user/pages/02.mypage文件夹中创建一个 .md 文件。在\user\config\system.yaml配置文件中启用 Markdown 语法。

使用 Markdown 语法有很多好处，其中一些如下所示。

它易于学习且字符最少。
当您使用 Markdown 时，出错的可能性非常小。
有效的 XHTML 输出。
您的内容和视觉显示保持分离，因此不会影响您网站的外观。
您可以使用任何文本编辑器或 Markdown 应用程序。

在以下部分中，我们将讨论 Markdown 中使用的 HTML 主要元素。

标题

每个标题标签都使用 # 为每个标题创建，即从 h1 到 h6，# 的数量如所示增加。

	#my new Heading
	##my new Heading
	###my new Heading
	####my new Heading
	#####my new Heading
	######my new Heading

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

注释

您可以使用以下格式编写注释。

<!—
   This is my new comment
-->

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

水平线

水平线用于在段落之间创建主题分隔符。您可以使用以下任何方法在段落之间创建分隔符。

___ - 三个下划线
--- - 三个破折号
*** - 三个星号

在浏览器中以localhost/Grav/mypage打开md文件；您将收到以下结果 -

正文

正文可以定义为以 Markdown 语法中的正常格式编写文本，不使用(p)标签

示例

It is a way of writing your plain text in an easy to read and write format, 
which later gets converted into HTML code.

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

强调

强调是 Markdown 语法中的编写格式，用于加粗、斜体或删除文本的一部分。让我们在下面讨论它们 -

加粗

可以使用两侧的两个(**)符号使文本的一部分变为粗体。

示例

The newest articles from **Advance Online Publication (AOP)** and the current issue.

在此示例中，我们必须将‘Advance Online Publication (AOP)’单词显示为粗体。

在浏览器中以localhost/Grav/mypage打开.md文件，您将收到以下结果 -

斜体

在单词的两侧使用“_”（下划线）符号使文本变为斜体。

示例

The newest articles from _Advance Online Publication_ (AOP) and the current issues.

在此示例中，我们必须将“Advance Online Publication” (AOP) 单词变为斜体。

在浏览器中以localhost/Grav/mypage打开.md文件。这将为您提供以下结果 -

删除线

在单词的两侧使用两个"~~"（波浪线）将单词删除。

示例

The newest articles from ~~Advance Online Publication~~ (AOP) and the current issues.

在此示例中，我们必须删除“Advance Online Publication” (AOP) 单词。

在浏览器中以localhost/Grav/mypage打开.md文件。这将为您提供以下结果 -

块引用

要创建块引用，您必须在句子或单词前添加>符号。

示例

>The newest articles from Advance Online Publication (AOP) and the current issues.

在此示例中，我们在句子前使用了 > 符号。

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

块引用也可以以下列方式使用 -

>The newest articles from Advance Online Publication (AOP) and the current issues.
>>> The newest articles from Advance Online Publication (AOP) and the current issues.

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

通知

通知可用于告知或通知某些重要事项。

有四种类型的通知 - 黄色、红色、蓝色和绿色。

黄色

您必须在描述!Info或信息的黄色通知类型之前使用>>>符号。

示例

>>>Neurotransmitter-gated ion channels of the Cys-loop receptor family are essential
mediators of fast neurotransmission throughout the nervous system and are implicated
in many neurological disorders.

红色

在红色警告通知之前使用四个>>>>符号。

示例

>>>>Neurotransmitter-gated ion channels of the Cys-loop receptor family are essential
mediators of fast neurotransmission throughout the nervous system and are implicated
in many neurological disorders.

蓝色

对于蓝色通知类型，使用五个>>>>>符号，这描述了一个注释。

示例

>>>>>Neurotransmitter-gated ion channels of the Cys-loop receptor family are essential
mediators of fast neurotransmission throughout the nervous system and are implicated
in many neurological disorders.

绿色

在绿色提示通知类型之前使用六个>>>>>>符号。

示例

>>>>>>Neurotransmitter-gated ion channels of the Cys-loop receptor family are essential
mediators of fast neurotransmission throughout the nervous system and are implicated
in many neurological disorders.

在浏览器中以localhost/Grav/mypage打开 md 文件；您将收到以下结果 -

列表

在本节中，我们将了解 Grav 中无序和有序列表的工作原理。

无序

在无序列表中，使用项目符号。使用*，-，+。符号作为项目符号。在任何文本之前使用带空格的符号，项目符号将显示。

示例

+ Bullet
+ Bullet
+ Bullet
   -Bullet
   -Bullet
   -Bullet
   *Bullet

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

有序

在列出内容之前添加数字。

示例

1. Coffee
2. Tea
3. Green Tea

在浏览器中以localhost/Grav/mypage打开.md文件。这将为您提供以下结果 -

代码

在本节中，我们将了解 Grav 中内联和块代码“围栏”的工作原理。

内联代码

使用(`)创建内联代码，以便在 Markdown 中使用代码。

示例

In the given example, '<section></section>' must be converted into code.

在浏览器中以localhost/Grav/mypage打开.md文件，您将收到以下结果 -

块代码“围栏”

如果您想阻止多行代码，请使用(```)围栏。

示例

```
You’re Text Here

```

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

表格

在 Grav 中，表格是通过在标题部分下方使用管道和破折号创建的。管道不得垂直对齐。

示例

| Number  |    Points       |
| ------  | -----------     |
|   1     | Eve Jackson 94  |
|   2     | John Doe 80     |
|   3     | Adam Johnson 67 |

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

右对齐文本

要使表格内容位于右侧，您必须在标题下方的破折号右侧添加一个冒号。

| Number |     Points      |
| ------:| -----------:    |
|   1    | Eve Jackson 94  |
|   2    | John Doe 80     |
|   3    | Adam Johnson 67 |

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

链接

在本节中，我们将了解 Grav 中链接的工作原理。

基本链接

链接是在[]方括号和()圆括号的帮助下创建的。在[]括号中，您必须编写内容，并在()中编写域名。

示例

[Follow the Given link](http://www.google.com)

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

添加标题

在本节中，我们将了解如何在 .md 文件中添加标题。

示例

[Google](https://www.gogle.com/google/ "Visit Google!")

在浏览器中以localhost/Grav/mypage打开.md文件；您将收到以下结果 -

图片

图片类似于链接，但在语法的开头有一个感叹号。

示例

![Nature] (/Grav/images/Grav-images.jpg)

在浏览器中以localhost/Grav/mypage打开.md文件，您将收到以下结果 -

打印页面