Markdownの表が崩れる原因と、崩さずに書くコツ

Markdownのコラム

執筆:松村 誠(植木鉢団 代表)

Markdownの表が崩れるとき、主な原因は3つです。
区切り行、全角で打った記号、セルの中のパイプと改行です。

そもそも表として認識される条件

Markdownの表には、ヘッダー行の下に区切り行が要ります。

| 項目 | 内容 |
| --- | --- |
| A | あ |

2行目の | --- | --- | が無いと表として扱われず、書いた文字列がそのまま出ます。
「表にならない」という症状のときは、まずここを疑うのが早いです。

区切り行のハイフンは3つでなくても構いません。
ただし列の数はヘッダー行と一致している必要があります。
ヘッダーが3列で区切り行が2列だと、表になりません。

表の前の空行は、無くても構いません。
LiteMD でも GitHub でも、段落のすぐ下に書いた表は、そのまま表になります。
空行が要るのは表の後ろのほうで、表のすぐ下に続けて書いた文章は、表の行として取り込まれます。
表を書き終えたら、次の文章との間に空行を1行入れておきます。

全角で打った記号では、表にならない

日本語入力のまま表を書くと、記号が全角になっていることがあります。
区切り行のハイフンを、長音の「ーーー」や全角の「---」で打つと、表になりません。
ヘッダー行の「|」が全角の場合も同じで、書いた行がそのまま文章として表示されます。

データの行の「|」だけが全角のときは、表にはなりますが、2つの値が1つのセルにまとまって表示されます。
※区切り行のハイフンの隣に全角スペースが1つ入っているだけでも、表になりませんでした。

区切り行はあるのに表にならないときは、記号とスペースを半角で打ち直すと直ります。
一方で、全角の文字でソースの縦の線が揃わないのは見た目だけの話で、表示には影響しません。揃え方は「日本語を含むMarkdownの表で、桁がずれて見える理由」に書いています。

セル内のパイプは書けない

セルの中に | をそのまま書くと、そこが列の区切りとして扱われます。
3列のつもりが4列になり、行ごとに列数がずれて崩れます。

回避するにはバックスラッシュでエスケープします。

| 記法 | 意味 |
| --- | --- |
| a \| b | aまたはb |

コードとして書きたい場合は、バッククォートで囲んでもエスケープが要ります。
`a|b` のように囲んだだけでは、パイプは区切りとして解釈されます。

セル内で改行はできない

Markdownの表は1行1レコードの構造なので、セルの中で改行すると、そこで行が終わったことになります。

どうしても改行を入れたい場合は <br> を書きます。
HTMLを許可している処理系であれば、これで同じセルの中に改行が入ります。

ただし、セル内に改行を入れたくなった時点で、その内容は表に向いていないことが多いです。
表の外に箇条書きで出したほうが読みやすくなる場合があります。

列の数が合わない行と、行の端のパイプ

値が無いセルは、パイプの間に何も書かずに空けておけば空欄になります。
ただし、セルを空けるときもパイプの数は減らさないでください。
パイプを省くと列の数が合わなくなり、そこから後ろの値が左にずれます。

逆に、パイプが多すぎる行は、ヘッダーより多い分のセルが表示されません。
エラーにはならず、値がそのまま消えるので、列を足したつもりの値が見当たらないときは、ヘッダー行の列の数を先に確かめてください。

行の先頭と末尾のパイプは、書かなくても表として扱われます。
ただ、書いておいたほうが列の数を数えやすく、空のセルが行の端にあるときに見落としにくくなります。
迷ったら、両端にも付けておくのが無難です。

迷ったら列を減らす

列が多い表ほど崩れやすくなります。
1行が長くなるほどパイプの数を数え間違えますし、セル内に改行を入れたくなるのも列が足りていない裏返しです。

表で持たせるのは項目名と短い値まで、と決めておくと崩れにくくなります。

そもそも手で書かない、という手もあります。
表計算ソフトで組んだ表をコピーして貼り付ければ、Markdownの表に変換できます。列が多い表や、数字の集計が要る表はそのほうが早いです。

Markdown表 相互変換で変換できます。表の記法そのものについてはMarkdownの表の書き方に詳しくまとまっています。