Grav - Markdown 语法

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

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

Grav 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文件；您将收到以下结果 -

Grav Markdown 语法

评论

您可以按照以下格式撰写评论。

<!—
   This is my new comment
-->

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

Grav Markdown 语法

水平规则

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

  • ___ - 三个下划线

  • --- − 三个破折号

  • *** − 三个星号

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

Grav Markdown 语法

正文副本

正文可以定义为以 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文件；您将收到以下结果 -

Grav Markdown 语法

强调

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

大胆的

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

例子

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

在此示例中，我们必须将“Advance Online Publication (AOP)”一词显示为粗体。

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

Grav Markdown 语法

斜体

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

例子

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

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

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

Grav Markdown 语法

删除线

在单词两侧使用两个“~~” （波形符）来删除该单词。

例子

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

在此示例中，我们必须删除“Advance Online Publication”（AOP）一词。

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

Grav Markdown 语法

块引用

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

例子

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

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

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

Grav Markdown 语法

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

>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文件；您将收到以下结果 -

Grav Markdown 语法

通知

通知可用于通知或通知某些重要的事情。

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

黄色的

您必须在描述!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 Markdown 语法

列表

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

无序

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

例子

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

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

Grav Markdown 语法

已订购

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

例子

1. Coffee
2. Tea
3. Green Tea

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

Grav Markdown 语法

代码

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

内联代码

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

例子

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

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

Grav Markdown 语法

块代码“栅栏”

如果要阻止多行代码，请使用(```)栅栏。

例子

```
You’re Text Here

```

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

Grav Markdown 语法

表格

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

例子

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

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

Grav Markdown 语法

右对齐文本

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

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

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

Grav Markdown 语法

链接

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

基本链接

链接是在 ([]) 方括号和 (()) 圆括号的帮助下建立的。[]括号内必须填写内容，()内填写域名。

例子

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

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

Grav Markdown 语法

添加标题

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

例子

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

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

Grav Markdown 语法

图片

图像与链接类似，但在语法开头有一个感叹号。

例子

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

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

Grav Markdown 语法