Grav - Markdown 语法
Markdown 语法被定义为以易于阅读和编写的格式编写纯文本,然后将其转换为 HTML 代码。Markdown 语法中使用 (*) 或 (`) 等符号。这些符号用于加粗、创建标题和组织内容。
要使用 Markdown 语法,您必须在 user/pages/02.mypage 文件夹中创建一个 .md 文件。在您的 \user\config\system.yaml 配置文件中启用 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 文件,您将收到以下结果 −
评论
您可以按照以下格式撰写评论。
<!— 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)' 单词显示为粗体。
在浏览器中将 .md 文件打开为 localhost/Grav/mypage,您将收到以下结果 −
斜体
在单词两侧使用 "_"(下划线)符号将文本变为斜体。
示例
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 文件。这将为您提供以下结果 −
Blockquote
要创建块引用,您必须在句子或单词前添加 > 符号。
示例
>The newest articles from Advance Online Publication (AOP) and the current issues.
在此示例中,我们在句子前使用了 > 符号。
在浏览器中以 localhost/Grav/mypage; 的形式打开 .md 文件,您将收到以下结果 −
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 文件,您将收到以下结果 −
通知
通知可用于通知或告知重要事项。
通知有四种类型 − 黄色、红色、蓝色和绿色。
黄色
在描述 !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 中使用代码。
示例
在给定的示例中,必须将"<section></section>"转换为代码。
在浏览器中以 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 文件,您将收到以下结果 −