Markdown markdown

當您正在編寫時,內容片段編輯器會使用​ Markdown ​語法,讓您輕鬆撰寫內容給Headless傳遞或頁面編寫:

NOTE
內容片段是 Sites 的一項功能,但儲存為​ 資產
編寫內容片段有兩個編輯器;雖然基本功能相同,但有一些差異。 本節涵蓋原始編輯器,主要是從​ Assets ​主控台存取。 請參閱網站檔案內容片段 — 製作,以取得新編輯器的詳細資訊(主要從​ 內容片段 ​主控台存取)。

Markdown 編輯器

您可以定義:

標題標籤法 heading-notation

若要建立標題,請在標題前面放置雜湊標籤(#)。 一個雜湊標籤(#)用於H1,兩個雜湊標籤(##)用於H2,以此類推。 您最多可以使用6個雜湊標籤。 例如:

## This is an H2

### This is an H3

###### This is a H6

或者,您可以等號加底線來建立H1,減號加底線來建立H2。 例如:

This is an H1

=============

This is an H2

-------------

段落和分行符號 paragraphs-and-line-breaks

段落只是一行或多行連續的文字,以一行或多行空白行分隔。 空白行是隻包含空格或定位字元的行。 不應以空格或定位點縮排一般段落。

換行符號的建立方式,是先以兩個或多個空格結束一行,然後再返回一行。

您可以建立內嵌和參照連結。

在這兩種樣式中,連結文字會以方括弧[]分隔。

以下是內嵌連結的範例:

This is [an example](https://example.com/ "Title") inline link.

This is [an example of an email link](emailto:myaddress@mydomain.info)

[This link](https://example.net/) has no title attribute.

參照連結的語法如下:

Hey you should [checkout][0] this [cool thing][wiki] that I [made][].

[0]: https://www.google.ca

[wiki]: https://www.wikipedia.org

[made]: https://www.stackoverflow.com

影像 images

影像的語法與連結類似。 您可以建立內嵌和參照的影像。

例如,內嵌影像的語法如下:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

語法包括:

  • 驚歎號:!;
  • 後面接著一組方括弧,其中包含影像的alt屬性文字;
  • 後面接著一組括弧(包含影像的URL或路徑),以及一個以雙引號或單引號括起來的選用標題屬性。

參照樣式影像的語法如下:

![Alt text][id]

其中「id」是定義的影像參考的名稱。 影像參照是使用與連結參照相同的語法來定義:

[id]: url/to/image "Optional title attribute"

區塊引號 block-quotes

您可以在文字前新增>符號來引用文字。 例如:

>This is block quotes

>asdhfjlkasdhlf

>asdfahsdlfasdfj

您可以有巢狀區塊引號。 例如:

> This is the first level of quoting.

>

>> This is nested blockquote.

>

> Back to the first level.

清單 lists

您可以建立已排序和未排序清單。

若要建立未排序清單,請在清單中的專案前使用*符號。 例如:

* item in list

* item in list

* item in list

若要建立有序清單,請在清單中的每個專案前新增數字,然後加上句點。 例如:

1. First item in list.

2. Second item in list.

3. Third item in list.

強調 emphasis

您可以新增斜體或粗體樣式至文字。

若要新增斜體,如下所示:

*single asterisks*

_single underscores_

Keyboard shortcut: Ctrl-I (Cmd-I)

您可以依照下列方式顯示粗體文字:

**double asterisks**

__double underscores__

Keyboard shortcut: Ctrl-B (Cmd-B)

若要指出程式碼範圍,請以反勾號(`)將程式碼換行。 和預先格式化的程式碼區塊不同,程式碼範圍表示一般段落中的程式碼。

例如:

Use the `printf()` function.

程式碼片段 code-blocks

程式碼區塊通常用於說明原始程式碼。 您可以使用索引標籤縮排程式碼,或最少4個空格來建立程式碼區塊。 例如:

This is a normal paragraph.

This is a code block.

反斜線逸出 backslash-escapes

您可以使用反斜線逸出產生在格式語法中具有特殊意義的常值字元。 例如,如果您想在單詞周圍加上常值星號(而不是HTML<em>標籤),則可以在星號前使用反斜線,如下所示:

\\*literal asterisks\\*

反斜線逸出適用於下列字元:

\ backslash

` backtick

* asterisk

_ underscore

{} curly braces

[] square brackets

() parentheses

# hash mark

+ plus sign

- minus sign (hyphen)

. dot

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab