Markdown の書き方一覧(チートシート)
よく使う Markdown の書き方は、見出しは行の頭に #、太字は ** で囲む、箇条書きは行の頭に - 、リンクは [文字](URL)、コードはバッククォート 3 つの行で囲む、の 5 つです。ここまでは標準の仕様(CommonMark)にあり、ほとんどのアプリで同じように表示されます。
表・チェックボックス・打ち消し線は、GitHub の拡張(GFM)の書き方です。数式・図・ハイライトなどはさらに外側の独自の書き方で、使えるかどうかはアプリによって違います。
標準(CommonMark)の書き方は?
| 書きたいもの | 書き方 | メモ |
|---|---|---|
| 見出し | # 見出し 〜 ###### 見出し | # は 1〜6 個。# のあとに空白が要る |
| 太字 | **太字** | __太字__ でもよい |
| 斜体 | *斜体* | _斜体_ でもよい |
| 箇条書き | - 項目 | * や + でもよい |
| 番号付きリスト | 1. 項目 | 1) でもよい |
| 引用 | > 引用 | 行の頭に > |
| リンク | [文字](https://example.com) | <https://example.com> でも URL がリンクになる |
| 画像 |  | リンクの頭に ! |
| 文中のコード | バッククォート 1 つずつで前後を囲む | 書き方は下の見本で |
| コードブロック | バッククォート 3 つの行で前後を囲む | ~~~ でもよい |
| 区切り線 | --- | *** や ___ でもよい |
| 改行 | 行の終わりに空白 2 つか \ | 空行を入れると段落が分かれる |
見出し
書き方# 見出し〜###### 見出しメモ#は 1〜6 個。#のあとに空白が要る太字
書き方**太字**メモ__太字__でもよい斜体
書き方*斜体*メモ_斜体_でもよい箇条書き
書き方- 項目メモ*や+でもよい番号付きリスト
書き方1. 項目メモ1)でもよい引用
書き方> 引用メモ行の頭に>リンク
書き方[文字](https://example.com)メモ<https://example.com>でも URL がリンクになる画像
書き方メモリンクの頭に!文中のコード
書き方バッククォート 1 つずつで前後を囲むメモ書き方は下の見本でコードブロック
書き方バッククォート 3 つの行で前後を囲むメモ~~~でもよい区切り線
書き方---メモ***や___でもよい改行
書き方行の終わりに空白 2 つか\メモ空行を入れると段落が分かれる
GitHub の拡張(GFM)で足される書き方は?
GitHub Flavored Markdown(GFM)は、CommonMark に次の書き方を「拡張」として足しています。多くの Markdown アプリも対応していますが、標準の CommonMark だけに沿うアプリでは、記号のまま出ることがあります。
| 書きたいもの | 書き方 | メモ |
|---|---|---|
| 表 | | 見出し | 見出し | の下に | --- | --- | | セルの結合はできない |
| チェックボックス | - [ ] 未完了 / - [x] 完了 | 箇条書きの頭に [ ] |
| 打ち消し線 | ~~打ち消し~~ | ~ は 1 つか 2 つ |
| URL の自動リンク | https://example.com と書くだけ | www. で始まる URL も |
表
書き方| 見出し | 見出し |の下に| --- | --- |メモセルの結合はできないチェックボックス
書き方- [ ] 未完了/- [x] 完了メモ箇条書きの頭に[ ]打ち消し線
書き方~~打ち消し~~メモ~は 1 つか 2 つURL の自動リンク
書き方https://example.comと書くだけメモwww.で始まる URL も
標準でない書き方には、何がある?
次の書き方は、CommonMark にも GFM の仕様にもありません。GitHub のサイトや、一部のアプリが独自に対応しているものです。
| 書きたいもの | 書き方 | 使えるところの例 |
|---|---|---|
| 数式 | $x^2$(文中)、$$ … $$(独立した行) | GitHub、数式に対応したアプリ |
| 図(Mermaid) | 言語名を mermaid にしたコードブロック | GitHub、Mermaid に対応したアプリ |
| 注意書き(コールアウト) | > [!NOTE] で始まる引用 | GitHub(NOTE・TIP・IMPORTANT・WARNING・CAUTION) |
| 脚注 | 本文に [^1]、下に [^1]: 注の文 | GitHub など |
| ハイライト(マーカー) | ==強調== | 対応したアプリだけ |
数式
書き方$x^2$(文中)、$$ … $$(独立した行)使えるところの例GitHub、数式に対応したアプリ図(Mermaid)
書き方言語名をmermaidにしたコードブロック使えるところの例GitHub、Mermaid に対応したアプリ注意書き(コールアウト)
書き方> [!NOTE]で始まる引用使えるところの例GitHub(NOTE・TIP・IMPORTANT・WARNING・CAUTION)脚注
書き方本文に[^1]、下に[^1]: 注の文使えるところの例GitHub などハイライト(マーカー)
書き方==強調==使えるところの例対応したアプリだけ
まとめて試せる見本は?
主な書き方を 1 つにまとめた見本です。コピーして、Markdown に対応したアプリに貼ると、どう表示されるかを確かめられます。
# 見出し 1 ## 見出し 2 ふつうの文。**太字**、*斜体*、~~打ち消し~~、`コード`。 - 箇条書き - 入れ子の箇条書き 1. 番号付き 2. 番号付き - [ ] まだのこと - [x] 終わったこと > 引用 | 名前 | 数 | | --- | ---: | | りんご | 3 | [リンク](https://example.com) ```js console.log("hello"); ``` ---