Markdownチートシート

AI作成データこのコンテンツのデータはAIが公式資料や辞書を参照して作成しました。正確さを心がけていますが、誤りが含まれる可能性があります。

Markdownの書き方を網羅したチートシート。見出し・リスト・リンク・画像・テーブル・コードブロック・引用など基本構文から応用まで実例付きで解説。

Markdown記法を構文と実例で網羅。書き方に迷ったらすぐ引ける

見出し

# の数で見出しレベル(h1〜h6)を指定します。# の後にはスペースを入れてください。

markdown
# 見出し1(h1)
## 見出し2(h2)
### 見出し3(h3)
#### 見出し4(h4)
##### 見出し5(h5)
###### 見出し6(h6)
補足: h1とh2は以下の代替記法でも書けます(Setext形式)。
markdown
見出し1
=======

見出し2
-------

テキスト装飾

テキストに太字、斜体、取り消し線、インラインコードなどの装飾を適用できます。

太字

markdown
**太字テキスト**
__太字テキスト__

斜体(イタリック)

markdown
*斜体テキスト*
_斜体テキスト_

太字+斜体

markdown
***太字かつ斜体***
___太字かつ斜体___

取り消し線

markdown
~~取り消し線テキスト~~

インラインコード

markdown
`console.log("Hello")` のようにバッククォートで囲みます。

上付き・下付き(HTML)

markdown
H<sub>2</sub>O は水の化学式です。
E = mc<sup>2</sup>
記法表示結果
**太字**太字
*斜体*斜体
~~取り消し~~取り消し
`コード`コード
***太字斜体***太字斜体

リスト

順序なしリスト

-*+ のいずれかで順序なしリストを作成できます。

markdown
- りんご
- バナナ
- みかん

* りんご
* バナナ
* みかん

順序付きリスト

数字とピリオドで順序付きリストを作成します。番号は自動で振り直されます。

markdown
1. 最初の項目
2. 次の項目
3. 最後の項目

1. すべて1で書いても
1. 自動的に番号が
1. 振られます

ネストしたリスト

インデント(スペース2〜4個)でリストをネストできます。

markdown
- 果物
  - りんご
    - ふじ
    - 紅玉
  - バナナ
- 野菜
  - にんじん
  - たまねぎ

タスクリスト(チェックボックス)

- [ ] で未完了、- [x] で完了のタスクリストを作成できます。

markdown
- [x] 完了したタスク
- [ ] 未完了のタスク
- [ ] もう一つの未完了タスク

インラインリンク

markdown
[リンクテキスト](https://example.com)
[タイトル付きリンク](https://example.com "リンクのタイトル")

参照リンク

リンクURLを文書の別の場所でまとめて定義できます。

markdown
[Google][1]と[Yahoo][2]を参照してください。

[1]: https://google.com "Googleのサイト"
[2]: https://yahoo.co.jp "Yahooのサイト"

URLの自動リンク

markdown
<https://example.com>
<user@example.com>

画像

markdown
![代替テキスト](image.png)
![代替テキスト](image.png "画像のタイトル")

画像にリンクを付ける

markdown
[![代替テキスト](image.png)](https://example.com)
種類記法
リンク[テキスト](URL)
画像![alt](URL)
画像+リンク[![alt](画像URL)](リンクURL)
参照リンク[テキスト][id]
自動リンク<URL>

コード

インラインコード

バッククォート(`)でテキストを囲みます。

markdown
変数 `count` の値を確認してください。

コード内にバッククォートを含める

二重バッククォートを使います。

markdown
`` ここに `バッククォート` を含められます ``

フェンス付きコードブロック

バッククォート3つ(```)またはチルダ3つ(~~~)で囲みます。開始行に言語名を指定するとシンタックスハイライトが有効になります。

markdown
```javascript
function hello() {
  console.log("Hello, World!");
}
```
markdown
```python
def hello():
    print("Hello, World!")
```

インデントによるコードブロック

行頭にスペース4つまたはタブ1つを置くとコードブロックになります。

markdown
通常のテキスト

    // これはコードブロックです
    const x = 1;
    console.log(x);
よく使う言語指定: javascript, typescript, python, html, css, bash, json, yaml, sql, go, rust, java, c, cpp, ruby, php, swift, kotlin, markdown

テーブル

パイプ(|)とハイフン(-)でテーブルを作成します。2行目のハイフンが列の区切りになります。

markdown
| 名前   | 年齢 | 職業       |
| ------ | ---- | ---------- |
| 田中   | 30   | エンジニア |
| 佐藤   | 25   | デザイナー |
| 鈴木   | 35   | マネージャー |

セルの配置(アライメント)

コロン(:)の位置で左寄せ・中央揃え・右寄せを指定します。

markdown
| 左寄せ     | 中央揃え   | 右寄せ     |
| :--------- | :--------: | ---------: |
| left       | center     | right      |
| テキスト   | テキスト   | テキスト   |
記法配置
:---左寄せ(デフォルト)
:---:中央揃え
---:右寄せ

引用

行頭に > を付けて引用ブロックを作成します。

markdown
> これは引用文です。
> 複数行にまたがることができます。

ネストした引用

markdown
> 第一レベルの引用
> > 第二レベルの引用
> > > 第三レベルの引用

引用内での装飾

引用ブロック内でも他のMarkdown記法を使えます。

markdown
> ## 引用内の見出し
>
> - リスト項目1
> - リスト項目2
>
> **太字**や*斜体*も使えます。
>
> `コード`も書けます。

水平線

以下のいずれかを行に単独で書くと水平線(<hr>)が挿入されます。3つ以上のハイフン、アスタリスク、アンダースコアを使います。

markdown
---

***

___

- - -

* * *
注意: --- は見出しのSetext記法と間違えやすいので、前後に空行を入れるのがおすすめです。

HTMLの埋め込み

MarkdownファイルにはHTMLタグを直接書くことができます。Markdownで表現できない装飾やレイアウトに便利です。

基本的なHTMLタグ

markdown
<div style="color: red;">赤いテキスト</div>

<details>
<summary>クリックで展開</summary>

ここに隠れたコンテンツを書きます。
Markdownの記法も使えます。

- リスト項目1
- リスト項目2

</details>

改行の挿入

markdown
行末にスペース2つで改行
または<br>タグを使います。

画像サイズの指定

Markdown標準では画像サイズを指定できませんが、HTMLなら可能です。

markdown
<img src="image.png" alt="説明" width="300" height="200">

テキストの配置

markdown
<div align="center">中央揃えのテキスト</div>

<p align="right">右寄せのテキスト</p>
注意: HTMLブロック内のMarkdown記法が有効かどうかはパーサーにより異なります。GitHub等では<details>内の空行の後にMarkdownが有効になります。

GitHub Flavored Markdown拡張

GitHub Flavored Markdown(GFM)は標準のMarkdownにいくつかの便利な拡張を追加しています。

タスクリスト

markdown
- [x] 実装完了
- [x] テスト完了
- [ ] レビュー待ち
- [ ] デプロイ

絵文字

コロンで囲んだショートコードで絵文字を挿入できます。

markdown
:smile: :+1: :heart: :rocket: :warning:
:tada: :bug: :memo: :fire: :star:
ショートコード絵文字用途
:bug:🐛バグ修正
:sparkles:新機能
:memo:📝ドキュメント
:rocket:🚀デプロイ・リリース
:warning:⚠️注意・警告

脚注

markdown
本文にこのように脚注を付けます[^1]。複数の脚注も可能です[^note]。

[^1]: 脚注の内容はここに書きます。
[^note]: 名前付きの脚注も使えます。

自動リンク

GFMではURLを直接書くだけで自動的にリンクになります。

markdown
https://github.com
https://example.com

取り消し線(GFM拡張)

markdown
~~このテキストに取り消し線が引かれます~~

シンタックスハイライト付きdiff

コードブロックの言語に diff を指定すると差分表示ができます。

markdown
```diff
- 削除された行
+ 追加された行
  変更のない行
```

アラート(GitHub独自拡張)

GitHubでは引用ブロック内に特定のキーワードを書くとアラート表示になります。

markdown
> [!NOTE]
> 参考情報や補足です。

> [!TIP]
> より良い方法のヒントです。

> [!IMPORTANT]
> 重要な情報です。

> [!WARNING]
> 注意が必要な情報です。

> [!CAUTION]
> 危険な操作に関する警告です。

メンションとイシュー参照

GitHub上では以下の記法で自動リンクが作成されます。

markdown
@username      ユーザーへのメンション
#123           イシューやPRへの参照
org/repo#123   別リポジトリのイシュー参照

こんなときに使えます

シーンMarkdownで表やコードブロックを書きたいとき
得られる情報構文例とレンダリング結果を並べて確認でき、すぐに正しい書き方がわかる

見出し・リスト・テーブル・コードブロックなど基本から応用まで網羅

よくある質問

このチートシートはGitHub Flavored Markdown(GFM)にも対応していますか?
はい。標準のMarkdown構文に加え、タスクリスト、絵文字ショートコード、脚注、アラート記法などGitHub Flavored Markdownの拡張もカバーしています。
テーブルのセルを中央揃えや右寄せにするにはどうすればいいですか?
テーブルの区切り行でコロンの位置を変えることで配置を指定できます。左寄せは :---、中央揃えは :---:、右寄せは ---: と書きます。詳しくはテーブルのセクションを参照してください。
Markdownファイル内でHTMLタグを使うことはできますか?
はい。Markdownでは直接HTMLタグを記述できます。画像サイズの指定、テキストの色変更、折りたたみ(details要素)など、Markdown標準では表現できないレイアウトに活用できます。