Markdown 記法の書き方とチートシート

Markdown 記法とはHTMLに変換できる文章を簡単に記述できる軽量マークアップ言語です。その書き方とチートシートを紹介します。

目次

  1. MarkdownとHTMLの対応表
  2. 見出し
    1. 見出しレベル1
    2. 見出しレベル2
    3. 見出しレベル3
    4. 見出しレベル4
    5. 見出しレベル5
    6. 見出しレベル6
  3. 改行
  4. 段落
    1. 右寄せ
    2. 中央揃え
  5. 箇条書き
    1. 順不同の箇条書き
    2. 順序あり箇条書き
  6. a
  7. 字体
    1. イタリック
    2. 太字
    1. 打ち消し線
  8. pre

MarkdownとHTMLの対応表

Markdown と HTML の対応表を次に示す。

MarkdownとHTMLの対応表
Markdown HTML
# text <h1>
## text <h2>
### text <h3>
#### text <h4>
##### text <h5>
###### text <h6>
[text](url) <a>
- text <ul>
1. text <ol>
*text* <i>
**text** <b>
~~text~~ <s>
    text <pre>

見出し

MarkdownはHTMLと同様に6つのレベルで見出しを記述できる。

見出しレベル1

Markdownで見出しレベル1を記述するには、「# 」に続けて見出しを書く。

Markdown入力

# header

HTML出力

<h1>header</h1>

見出しレベル2

Markdownで見出しレベル2を記述するには、「## 」に続けて見出しを書く。

Markdown入力

## header

HTML出力

<h2>header</h2>

見出しレベル3

Markdownで見出しレベル3を記述するには、「### 」に続けて見出しを書く。

Markdown入力

### header

HTML出力

<h3>header</h3>

見出しレベル4

Markdownで見出しレベル4を記述するには、「#### 」に続けて見出しを書く。

Markdown入力

#### header

HTML出力

<h4>header</h4>

見出しレベル5

Markdownで見出しレベル5を記述するには、「##### 」に続けて見出しを書く。

Markdown入力

##### header

HTML出力

<h5>header</h5>

見出しレベル6

Markdownで見出しレベル6を記述するには、「###### 」に続けて見出しを書く。

Markdown入力

###### header

HTML出力

<h6>header</h6>

改行

Markdown において改行で区切られたテキストは、HTML において br 要素に変換される。

Markdown入力

foo
bar
baz

ブラウザ出力

foo
bar
baz

HTML出力

foo<br>bar<br>baz

段落

Markdownにおいて、空行で区切られたテキストは段落になる。

Markdown入力

foo

bar

baz

ブラウザ出力

foo

bar

baz

HTML出力

<p>foo</p>
<p>bar</p>
<p>baz</p>

Markdown記法において、表は次のように記載する。


| CODE | BANK            |
|------|-----------------|
| 0001 | Mizuho Bank     |
| 9900 | Japan Post Bank |
CODEBANK
0001Mizuho Bank
9900Japan Post Bank

このMarkdown記法は、次のHTMLに相当する。

<table>
  <thead>
    <tr>
      <th>CODE</th>
      <th>BANK</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>0001</td>
      <td>Mizuho Bank</td>
    </tr>
    <tr>
      <td>9900</td>
      <td>Japan Post Bank</td>
    </tr>
  </tbody>
</table>

中央揃え

Markdown記法でテーブルのセルを中央揃えにするには、仕切り線の両端にコロンを付ける。

| CODE | BANK            |
|------|:---------------:|
| 0001 | Mizuho Bank     |
| 9900 | Japan Post Bank |
CODEBANK
0001 Mizuho Bank
9900 Japan Post Bank

Markdown記法でテーブルのセルを右寄せにするには、仕切り線の右端にコロンを付ける。


| MOUNTAIN | HEIGHT |
|----------|-------:|
| Takao    | 599m   |
| Fuji     | 3,776m |
MOUNTAINHEIGHT
Takao 599m
Fuji 3,776m

箇条書き

順不同の箇条書き

Markdown記法において、順不同の箇条書きは次のように記載する。

- item1
- item2
- item3

上記のMarkdownは次のように表示される。

このMarkdown記法は、次のHTMLに相当する。

<ul>
  <li>item1</li>
  <li>item2</li>
  <li>item3</li>
</ul>

順不同の箇条書きを階層化するには、インデント(字下げ)をすればよい。

- item1
  - item1.1
  - item1.2
- item2
- item3

上記のMarkdownは次のように表示される。

順序あり箇条書き

Markdownにおいて、順序あり箇条書きは次のように記載する。

1. item1
1. item2
1. item3

上記のMarkdownは次のように表示される。

  1. item1
  2. item2
  3. item3

数字は何でもよい。入力のしやすさや修正の容易さからいえば、すべて1にするのが簡単である。見やすさからいえば、数字を変えた方がよい。

1. item1
2. item2
3. item3

上記のMarkdownは、次のHTMLに相当する。

<ol>
  <li>item1</li>
  <li>item2</li>
  <li>item3</li>
</ol>

順序ありリストを階層化するには、インデント(字下げ)をすればよい。

1. item1
  1. item1.1
  1. item1.2
1. item2
1. item3

上記のMarkdownは次のように表示される。

  1. item1
    1. item1.1
    2. item1.2
  2. item2
  3. item3

Markdownにおいて、リンク(アンカー)は次のように記載する。

[資産運用のすゝめ](https://tsuker.net/)

資産運用のすゝめ

このMarkdownは、次のHTMLに相当する。

<a href="https://tsuker.net/">資産運用のすゝめ</a>

字体

イタリック

Markdownにおいて、強調は次のように記載する。

This is *emphasized* word.

This is emphasized word.

このMarkdownは、次のHTMLに相当する。

This is <em>emphasized</em> word.

太字

Markdownにおいて、強調は次のように記載する。

Markdownの **強調** はこのように記載します。

Markdownの強調はこのように記載します。

このMarkdownは、次のHTMLに相当する。

Markdownの<strong>強調</strong>はこのように記載します。

打ち消し線

Markdown記法において打ち消し線を引くには、次のように記載する。

~~strikethrough~~

strikethrough

このMarkdownは、次のHTMLに相当する。

<del>strikethrough</del>

整形済みテキスト

Markdown記法において整形済みテキストを記述するには、行頭に空白を4つ入れるか、行頭にタブを入れる。

    preformatted text
preformatted text

このMarkdownは、次のHTMLに相当する。

<pre>preformatted text</pre>

参考文献

The Daring Fireball Company LLC. (2022) Markdown