Markdown スタイルガイド

9 min

以下は基本的な Markdown 構文の例と、Retypeset テーマでのスタイル効果です。

見出し

テキストの前にシャープ記号 # とスペースを追加することで、見出しを作成できます。シャープ記号の数が見出しのレベルに対応します。

構文

# 見出し 1
## 見出し 2
### 見出し 3
#### 見出し 4
##### 見出し 5
###### 見出し 6

効果

見出し 1

見出し 2

見出し 3

見出し 4

見出し 5
見出し 6

段落

空行を使用してテキストを区切ることで、段落を作成できます。

構文

孔乙己が店に入ると、酒を飲んでいた人々は皆彼を見て笑い、中には「孔乙己、顔にまた新しい傷ができたな!」と声をかける者もいた。彼は答えず、店の主人に「お酒を二杯温めて、茴香豆を一皿」と言い、九文の銭を出した。彼らはまた意図的に大声で「また人の物を盗んだに違いない!」と言った。孔乙己は目を大きく開いて「どうして人の清白を無実に汚すのか…」「何が清白だ?一昨日、何家の本を盗んで、吊るされて叩かれたのを見たぞ」と言われると、孔乙己は顔を赤くし、額の青筋が浮き上がり、「書を盗むのは盗みとは言えない…書を盗む!…読書人の行いが、どうして盗みと言えようか?」と反論し、続いて「君子固窮」や「者乎」などの難解な言葉を並べ立て、人々を大笑いさせた。店内外は陽気な空気に満ちていた。

人々の裏話によると、孔乙己はもともと勉強していたが、結局科挙に合格せず、生計を立てる方法も知らなかった。そのため、だんだん貧しくなり、ついには物乞いをしなければならなくなった。

効果

孔乙己が店に入ると、酒を飲んでいた人々は皆彼を見て笑い、中には「孔乙己、顔にまた新しい傷ができたな!」と声をかける者もいた。彼は答えず、店の主人に「お酒を二杯温めて、茴香豆を一皿」と言い、九文の銭を出した。彼らはまた意図的に大声で「また人の物を盗んだに違いない!」と言った。孔乙己は目を大きく開いて「どうして人の清白を無実に汚すのか…」「何が清白だ?一昨日、何家の本を盗んで、吊るされて叩かれたのを見たぞ」と言われると、孔乙己は顔を赤くし、額の青筋が浮き上がり、「書を盗むのは盗みとは言えない…書を盗む!…読書人の行いが、どうして盗みと言えようか?」と反論し、続いて「君子固窮」や「者乎」などの難解な言葉を並べ立て、人々を大笑いさせた。店内外は陽気な空気に満ちていた。

人々の裏話によると、孔乙己はもともと勉強していたが、結局科挙に合格せず、生計を立てる方法も知らなかった。そのため、だんだん貧しくなり、ついには物乞いをしなければならなくなった。

画像

感嘆符 !、角括弧 []、丸括弧 () を使用して画像を追加できます。これらの記号は全て半角記号を使用し、全角記号は使用しません。

構文

![画像の説明](./full/or/relative/path/of/image)

効果

画像の説明

引用ブロック

段落の前に > 記号とスペースを追加することで、引用ブロックを作成できます。段落間の空行に > 記号を追加することで、複数の段落を含めることができます。引用元を示す必要がある場合は、<cite> または <footer> タグを使用して出典を追加し、[^1] または [^note] 形式で脚注を挿入できます。

複数段落の引用

構文

> 天地不仁、以万物為芻狗。
>
> **注意**:引用ブロック内でも _Markdown 構文_ が使えます。

効果

天地不仁、以万物為芻狗。

注意:引用ブロック内でも Markdown 構文 が使えます。

出典付きの引用

構文

> 私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。
>
> —— <cite>『秋の夜』[^1]</cite>

[^1]: [『秋の夜』](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85))は魯迅の散文詩集『野草』の最初の散文詩で、1924年に書かれました。

効果

私の裏庭からは塀の外に二本の木が見える。一本はナツメの木で、もう一本もナツメの木だ。

—— 『秋の夜』1

ハイフン --- を3つ以上使用してタイトルを区切り、パイプ記号 | を使用して列を区切ることで、表を作成できます。

構文

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

効果

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

コードブロック

コードの上部と下部に3つのバッククォート ``` を追加することで、コードブロックを作成できます。上部のバッククォートの後に言語タイプ(html、javascript、css、markdownなど)を指定することで、シンタックスハイライトを実現できます。

構文

```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番目の項目

順序なしリスト

構文

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

効果

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

ネストされたリスト

構文

- フルーツ
  - リンゴ
  - オレンジ
  - バナナ
- 野菜
  - 青菜
  - 大根

効果

  • フルーツ
    • リンゴ
    • オレンジ
    • バナナ
  • 野菜
    • 青菜
    • 大根

その他の要素

<sup> 上付き文字、<sub> 下付き文字、<abbr> 略語、<del> 取り消し線、<u> 波線、<kbd> キーボード入力、<mark> ハイライトなどが含まれます。

構文

H<sub>2</sub>O

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

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

本は人類の進歩の<del>階段</del>梯子である

優れた作家は常に<u title="スペリング">つづり</u>の間違いをチェックします。

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

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

効果

H2O

Xn + Yn = Zn

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

本は人類の進歩の階段梯子である

優れた作家は常につづりの間違いをチェックします。

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

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

Footnotes

  1. 『秋の夜』は魯迅の散文詩集『野草』の最初の散文詩で、1924年に書かれました。