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檔案，您將收到以下結果 -

列印頁面