Markdownスタイルガイド


AstroでMarkdownコンテンツを書く際に使用できる基本的なMarkdown構文のサンプルです。

見出し

以下のHTML <h1><h6> 要素は、6段階のセクション見出しを表します。<h1> が最も高いセクションレベルで、<h6> が最も低いレベルです。

H1

H2

H3

H4

H5
H6

段落

吾輩は猫である。名前はまだ無い。どこで生れたかとんと見当がつかぬ。何でも薄暗いじめじめした所でニャーニャー泣いていた事だけは記憶している。吾輩はここで始めて人間というものを見た。しかもあとで聞くとそれは書生という人間中で一番獰悪な種族であったそうだ。この書生というのは時々我々を捕えて煮て食うという話である。

しかしその当時は何という考もなかったから別段恐しいとも思わなかった。ただ彼の掌に載せられてスーと持ち上げられた時何だかフワフワした感じがあったばかりである。

画像

構文

![代替テキスト](./画像への/フル/または/相対/パス)

出力

ブログプレースホルダー

引用

引用要素は、他のソースから引用されたコンテンツを表します。オプションで footer または cite 要素内に出典を記載でき、注釈や略語などのインライン変更も含めることができます。

出典なしの引用

構文

> これはサンプルの引用文です。
> **注意** 引用内でも _Markdown構文_ を使用できます。

出力

これはサンプルの引用文です。 注意 引用内でも Markdown構文 を使用できます。

出典ありの引用

構文

> メモリを共有して通信するのではなく、通信してメモリを共有せよ。<br>
> — <cite>Rob Pike[^1]</cite>

出力

メモリを共有して通信するのではなく、通信してメモリを共有せよ。
Rob Pike1

構文

| イタリック | 太字     | コード   |
| ---------- | -------- | -------- |
| _斜体_     | **太字** | `コード` |

出力

イタリック太字コード
斜体太字コード

コードブロック

構文

3つのバッククォート ``` を新しい行に記述し、スニペットを書いた後、新しい行で3つのバッククォートで閉じます。言語固有の構文をハイライトするには、最初の3つのバッククォートの後に言語名を1語書きます。例:html, javascript, css, markdown, typescript, txt, bash

```html
<!doctype html>
<html lang="ja">
	<head>
		<meta charset="utf-8" />
		<title>HTML5ドキュメントの例</title>
	</head>
	<body>
		<p>テスト</p>
	</body>
</html>
```

出力

<!doctype html>
<html lang="ja">
	<head>
		<meta charset="utf-8" />
		<title>HTML5ドキュメントの例</title>
	</head>
	<body>
		<p>テスト</p>
	</body>
</html>

リストの種類

順序付きリスト

構文

1. 最初の項目
2. 2番目の項目
3. 3番目の項目

出力

  1. 最初の項目
  2. 2番目の項目
  3. 3番目の項目

順序なしリスト

構文

- リスト項目
- 別の項目
- さらに別の項目

出力

  • リスト項目
  • 別の項目
  • さらに別の項目

ネストしたリスト

構文

- フルーツ
  - りんご
  - オレンジ
  - バナナ
- 乳製品
  - 牛乳
  - チーズ

出力

  • フルーツ
    • りんご
    • オレンジ
    • バナナ
  • 乳製品
    • 牛乳
    • チーズ

その他の要素 — 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. 上記の引用は、2015年11月18日のGopherfestでのRob Pikeの講演からの抜粋です。