Markdown

オーサリング中に、コンテンツフラグメントエディターは Markdown 構文を使用してユーザーがヘッドレスコンテンツを簡単に記述できるようにします。

以下を定義できます。

• 見出し表記
• 段落と改行
• リンク
• 画像
• ブロック引用
• リスト
• 強調
• コードブロック
• バックスラッシュエスケープ

見出し表記

ヘッダーを作成するには、見出しの前にハッシュタグ（#）を配置します。H1 には 1 つのハッシュタグ (#) が使用され、H2 には 2 つのハッシュタグ (##) が使用されます。 最大 6 個のハッシュタグを使用できます。次に例を示します。

## This is an H2

### This is an H3

###### This is a H6

オプションとして、テキストに等号で下線を付けて H1、マイナス記号でテキストに下線を付けて H2 を作成できます。次に例を示します。

This is an H1

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

This is an H2

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

段落と改行

段落は、1 つ以上の空白行で区切られた、1 つ以上の連続するテキスト行です。空白行とは、スペースやタブ以外を含まない行です。通常の段落はスペースまたはタブでインデントされません。

改行するには、行の末尾に 2 つ以上のスペースを付けてからリターンします。

リンク

インラインリンクと参照リンクを作成できます。

どちらのスタイルでも、リンクテキストはブラケット [] で囲みます。

インラインリンクの例を次に示します。

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

画像

画像の構文はリンクと似ています。インライン画像と参照画像を作成できます。

例えば、インライン画像の構文は次のようになります。

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

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

構文の内容は次のとおりです。

• 感嘆符：! 。
• 1 組のブラケットが後に続き、その中に画像の alt 属性テキストが含まれています。
• 1 組の丸括弧が後に続き、その中に画像の URL またはパスが含まれています。さらに、title 属性を二重引用符または一重引用符で囲んで指定することもできます。

参照スタイルの画像の構文は次のとおりです。

![Alt text][id]

「id」は、定義された画像参照の名前です。画像参照は、次のようにリンク参照と同じ構文を使用して定義されます。

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

ブロック引用

テキストの前に > 記号を追加すると、テキストを引用できます。次に例を示します。

>This is block quotes

>asdhfjlkasdhlf

>asdfahsdlfasdfj

ネストされたブロック引用符を使用できます。次に例を示します。

> This is the first level of quoting.

>

>> This is nested blockquote.

>

> Back to the first level.

リスト

順序付きと順序なし両方のリストを作成できます。

順序なしリストを作成するには、* 記号をリストの項目の前に付けます。次に例を示します。

* item in list

* item in list

* item in list

順序付きリストを作成するには、リスト内の各項目の前に数字とピリオドを 1 つ追加します。次に例を示します。

1. First item in list.

2. Second item in list.

3. Third item in list.

強調

斜体または太字のスタイルをテキストに追加できます。

次のように斜体を追加できます。

*single asterisks*

_single underscores_

Keyboard shortcut: Ctrl-I (Cmd-I)

次のようにテキストを太字にすることができます。

**double asterisks**

__double underscores__

Keyboard shortcut: Ctrl-B (Cmd-B)

コードの範囲を示すには、バッククォート（`）で囲みます。事前に形式設定されたコードブロックとは異なり、コード範囲は通常の段落内のコードを示します。

次に例を示します。

Use the `printf()` function.

コードブロック

コードブロックは、通常、ソースコードを説明するために使用されます。タブを使用するかまたは少なくとも 4 つのスペースを使用して、コードをインデントすることで、コードブロックを作成できます。次に例を示します。

This is a normal paragraph.

This is a code block.

バックスラッシュエスケープ

書式設定構文で特殊な意味を持つリテラル文字を表示するには、バックスラッシュエスケープを使用します。例えば、ある単語を（HTML の <em> タグではなく）リテラルアスタリスクで囲みたい場合は、次のようにアスタリスクの前にバックスラッシュを使用します。

\\*literal asterisks\\*

バックスラッシュエスケープは次の文字に使用できます。

\ backslash

` backtick

* asterisk

_ underscore

{} curly braces

[] square brackets

() parentheses

# hash mark

+ plus sign

- minus sign (hyphen)

. dot