Markdown スタイルガイド

これは、Astro で Markdown コンテンツを書くときに使える、基本的な Markdown 構文のサンプルです。

見出し

HTML の <h1> から <h6> は、6段階の見出しレベルを表します。<h1> が最上位、<h6> が最下位です。

H1

H2

H3

H4

H5
H6

段落

これは段落の例です。Markdown では通常の文章をそのまま書くことで、読みやすい本文を作成できます。

段落を分けたい場合は、1 行以上空けて次の文章を書きます。

画像

構文

![代替テキスト](./full/or/relative/path/of/image)

出力

blog placeholder

引用

blockquote 要素は、他のソースから引用した内容を表します。必要に応じて出典も添えられます。

出典なしの引用

構文

> これは引用文の例です。  
> **補足** として _Markdown 構文_ も使えます。

出力

これは引用文の例です。
補足 として Markdown 構文 も使えます。

出典付きの引用

構文

> 記憶を共有して意思疎通するのではなく、意思疎通によって記憶を共有しよう。<br>
> — <cite>Rob Pike[^1]</cite>

出力

記憶を共有して意思疎通するのではなく、意思疎通によって記憶を共有しよう。
Rob Pike1

テーブル

構文

| 斜体      | 太字     | コード   |
| --------- | -------- | -------- |
| _斜体_    | **太字** | `code`   |

出力

斜体太字コード
斜体太字code

コードブロック

構文

新しい行でバッククォート 3 つ ``` を書いてコードを囲みます。言語名を指定すると、構文ハイライトが有効になります。

```html
<!doctype html>
<html lang="ja">
	<head>
		<meta charset="utf-8" />
		<title>Example HTML5 Document</title>
	</head>
	<body>
		<p>Test</p>
	</body>
</html>
```

出力

<!doctype html>
<html lang="ja">
	<head>
		<meta charset="utf-8" />
		<title>Example HTML5 Document</title>
	</head>
	<body>
		<p>Test</p>
	</body>
</html>

リストの種類

順序付きリスト

構文

1. 1つ目
2. 2つ目
3. 3つ目

出力

  1. 1つ目
  2. 2つ目
  3. 3つ目

順序なしリスト

構文

- リスト項目
- もう1つの項目
- さらに別の項目

出力

  • リスト項目
  • もう1つの項目
  • さらに別の項目

入れ子リスト

構文

- 果物
  - りんご
  - オレンジ
  - バナナ
- 乳製品
  - 牛乳
  - チーズ

出力

  • 果物
    • りんご
    • オレンジ
    • バナナ
  • 乳製品
    • 牛乳
    • チーズ

その他の要素 - abbr, sub, sup, kbd, mark

構文

<abbr title="Graphics Interchange Format">GIF</abbr> はビットマップ画像形式です。

H<sub>2</sub>O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

<kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>Delete</kbd> を押してセッションを終了します。

ほとんどの <mark>サンショウウオ</mark> は夜行性で、昆虫やミミズ、小さな生き物を捕食します。

出力

GIF はビットマップ画像形式です。

H2O

Xn + Yn = Zn

CTRL + ALT + Delete を押してセッションを終了します。

ほとんどの サンショウウオ は夜行性で、昆虫やミミズ、小さな生き物を捕食します。

Footnotes

  1. 上の引用は、Rob Pike による talk からの抜粋です。