当前位置: 首页 > 文档资料 > Grav 入门教程 >

Markdown 语法

优质
小牛编辑
126浏览
2023-12-01

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

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

Grav Markdown语法

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

  • 它易于学习,并且具有最少的字符。

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

  • 有效的XHTML输出。

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

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

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

Headings

对于每个标题,每个标题标签用#创建,即,从h1到h6,#的数量增加,如图所示。

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

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

Grav Markdown语法

注释 (Comments)

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

<!—
   This is my new comment
-->

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

Grav Markdown语法

横向规则

水平规则用于在段落之间创建主题中断。 您可以使用以下任何方法在段落之间创建中断。

  • ___ - 三个下划线

  • --- - 三个破折号

  • *** - 三个星号

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

Grav Markdown语法

正文复印件

正文Body copy可以定义为在标记语法中以正常格式编写文本,使用no (p)标记

例子 (Example)

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文件localhost/Grav/mypage; 您将收到以下结果 -

Grav Markdown语法

Emphasis

Emphasis是markdown语法中的书写格式,用于粗体,斜体或删除部分文本。 我们在下面讨论它们 -

Bold

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

Example

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

在这个例子中,我们必须将'Advance Online Publication (AOP)'这个词显示为粗体。

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

Grav Markdown语法

Italics

在单词的任一侧使用“_” (下划线)标记以使文本为斜体。

Example

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

在这个例子中,我们必须用斜体“Advance Online Publication” (AOP)这个词。

在浏览器中以localhost/Grav/mypage打开.md文件。 这将给你以下结果 -

Grav Markdown语法

删除线(Strikethrough)

在单词的两边使用两个"~~" (波浪形)来删除单词。

Example

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

在这个例子中,我们必须打击“高级在线出版物”(AOP)这个词。

在浏览器中以localhost/Grav/mypage打开.md文件。 这将给你以下结果 -

Grav Markdown语法

Blockquote (Blockquote)

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

Example

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

在这个例子中,我们在句子前面使用了一个>符号。

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

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文件localhost/Grav/mypage; 您将收到以下结果 -

Grav Markdown语法

Notices

通知可用于通知或通知重要事项。

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

Yellow

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

Example

>>>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.

Red

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

Example

>>>>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.

Blue

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

Example

>>>>>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.

Green

在绿色通知类型之前使用六个》》》》》》符号,这描述了一个提示。

Example

>>>>>>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文件localhost/Grav/mypage; 您将收到以下结果 -

Grav Markdown语法

Lists

在本节中,我们将了解无序和有序列表如何在Grav中工作。

无序(Unordered)

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

Example

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

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

Grav Markdown语法

Ordered

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

Example

1. Coffee
2. Tea
3. Green Tea

在浏览器中以localhost/Grav/mypage打开.md文件。 这将给你以下结果 -

Grav Markdown语法

Code

在本节中,我们将了解内联和块代码“围栏”如何在Grav中工作。

内联代码

使用(`)内联代码以在markdown中使用代码。

Example

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

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

Grav Markdown语法

区号“围栏”

如果要阻止多行代码,请使用(```)

Example

```
You’re Text Here
```

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

Grav Markdown语法

Tables

在Grav中,通过在标题部分下使用管道和短划线创建表。 管道不得垂直对齐。

例子 (Example)

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

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

Grav Markdown语法

右对齐文本

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

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

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

Grav Markdown语法

Links

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

基本链接

链接是在([])方括号和(())括号的帮助下完成的。 在[]括号中,您必须编写内容并在()写入域名。

Example

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

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

Grav Markdown语法

添加标题

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

Example

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

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

Grav Markdown语法

Images

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

Example

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

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

Grav Markdown语法