Markdown で表を書くには？ セル内の改行や結合はできる？
Markdown の表は、縦線（|）で列を区切り、見出しの行のすぐ下に | --- | --- | の区切りの行を書きます。そのあとに 1 行ずつデータの行を書きます。これは GitHub の拡張（GFM）の書き方で、標準の CommonMark にはありませんが、多くのアプリが対応しています。
セルの中の改行と、セルの結合（横や縦につなぐ）の書き方は、GFM の仕様にありません。セルの中で改行したいときは、HTML が使えるところなら <br> を書く方法が広く使われます。結合が要るときは、HTML の表で書くか、表を分けます。
表は、どう書く？
| 名前 | 色 | 値段 | | --- | --- | ---: | | りんご | 赤 | 150 | | バナナ | 黄 | 120 |
- 1 行目が見出し、2 行目が区切りの行、3 行目からがデータです。
- 区切りの行の列の数は、見出しの行と同じにします。違うと表になりません。データの行は、足りない列が空になり、多い列は捨てられます。
- 区切りの行の
-は、GitHub は 3 つ以上を案内しています。 - 表の前には空行を入れます（GitHub の案内）。行の両端の
|は省けますが、つけたほうが読みやすくなります。 - 列の幅をそろえて書く必要はありません。
左寄せ・中央・右寄せにするには？
区切りの行の - の左右に : をつけて、列の文字の寄せ方を決めます。数や値段の列は右寄せにすると、けたがそろって読みやすくなります。
| 区切りの行 | 寄せ方 |
|---|---|
:--- | 左寄せ |
:---: | 中央 |
---: | 右寄せ |
---（: なし） | アプリのふだんの寄せ方 |
:---寄せ方左寄せ:---:寄せ方中央---:寄せ方右寄せ---（:なし）寄せ方アプリのふだんの寄せ方
セルの中で改行したり、| を書いたりするには？
- 改行: GFM の仕様では、表のセルには箇条書きや段落などのまとまり（ブロック）を入れられず、1 行で書きます。HTML が使えるところでは、
1 行目<br>2 行目のように<br>で改行する方法が使われます。 - 縦線を文字として書く: セルの中の
|は列の区切りになるので、\|と前にバックスラッシュをつけます。 - 太字・リンク・コード: セルの中でも、
**太字**や[リンク](URL)、文中のコードは使えます。
セルの結合はできる？ 背景色は？
標準の Markdown（CommonMark・GFM）には、セルを結合する書き方も、背景色をつける書き方もありません。どうしても必要なときは、HTML が使えるところで、HTML の表（<table> の colspan・rowspan）を書きます。ただ、表示するアプリやサイトによっては HTML が消されるので、見出しの列を足して表を分けるほうが、どこでも崩れません。