Grav - Markdown 语法

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

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

Grav Markdown 语法

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

  • 它易于学习且字符数最少。

  • 使用 markdown 时,出错的可能性很小。

  • 有效的 XHTML 输出。

  • 您的内容和视觉显示保持分开,因此不会影响您网站的外观。

  • 您可以使用任何文本编辑器或 markdown 应用程序。

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

标题

每个标题标签都使用 # 来创建,即从 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)' 单词显示为粗体。

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

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 语法

Blockquote

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

示例

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

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

在浏览器中以 localhost/Grav/mypage; 的形式打开 .md 文件,您将收到以下结果 −

Grav Markdown 语法

Blockquote 也可以按以下方式使用 −

>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 中使用代码。

示例

在给定的示例中,必须将"<section></section>"转换为代码。

在浏览器中以 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 语法