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の表の書き方に詳しくまとまっています。