日本語を含むMarkdownの表で、桁がずれて見える理由

Markdown表・表データ変換コラム

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

日本語混じりのMarkdownの表は、書いている最中に崩れて見えることがあります。

こういう状態のことです。

| 商品名 | 単価 | 区分 |
| ------ | ---- | ---- |
| りんご | 120 | 果物 |
| アイスクリーム | 380 | 冷凍食品 |
| 水 | 90 | 飲料 |

| の位置がバラバラで、どこが何列目なのか追いづらい状態です。

原因は文字の幅

原因は単純で、日本語の文字が半角文字のおよそ2倍の幅を持っているためです。

等幅フォントで表示したとき、りんご は6文字ぶんの幅を占めます。
一方 apple は5文字ぶんです。
文字数だけを数えて空白を詰めると、見た目の幅は揃いません。

文字数だけで桁を揃えると、日本語を入れた時点でこうなります。

文字数で揃えた表と、表示幅で揃えた表の比較

表示結果には影響しない

ソースがずれていても、表示された表は正しく整列します。

Markdownの表は | の位置ではなく、| で区切られた個数で列を判断しています。
なので、桁が揃っていなくても表示は崩れません。
極端な話、こう書いても結果は同じです。

|商品名|単価|区分|
|-|-|-|
|りんご|120|果物|

それでも揃える意味

表示に影響しないなら揃える必要はないのですが、揃っていると、次の点で楽になります。

  • 後から1行足すとき、どの列に何を書くのか目で追える
  • 値の入れ間違い(単価の欄に区分を書いてしまう等)に気づきやすい
  • 差分(Gitのdiff等)で変更箇所を見つけやすい

書いて終わりの表なら気にしなくていいと思いますが、後で編集するものは揃えておいた方が結局は楽になります。

全角を考慮した桁揃え

このツールでは、文字数ではなく表示上の幅で桁を計算しています。
全角文字を幅2として数えているので、日本語の表でも | が縦に並びます。

※ 揃うのは等幅フォントで見た場合です。プロポーショナルフォントのエディタで開くと、どのみち揃って見えません。
※ 絵文字は環境によって表示幅が変わるので、揃わない場合があります。

幅が決まらない記号もある

「①」「※」「→」「○」のような記号は、環境によって幅1で表示されたり、幅2で表示されたりします。
Unicodeで「曖昧な幅」とされている文字で、日本語のフォントでは幅2、欧文のフォントでは幅1になりやすい文字です。

このツールは、これらの記号を幅1として数えています。
日本語のフォントで開くと幅2で表示されることが多いので、記号を含む列だけ | が少しずれる場合があります。
気になる場合は、「①」を「1.」、「→」を「->」のように、半角の文字に置き換えると揃います。

半角カナは幅1

「アイウ」のような半角カナは、見た目どおり幅1です。
全角の「アイウ」とは幅が違うので、同じ列に混ざっていると、文字数が同じでも長さが揃いません。
このツールでも、半角カナは幅1として数えています。

元のデータに半角カナが混ざっている場合は、表計算ソフトの側で全角にそろえてから変換すると、見た目も文字の種類も統一できます。

揃えたあとに書き換えると、またずれる

揃った表でも、あとから1つのセルを書き換えると、その列の幅が変わります。
長い値を入れればその行だけ | が右に押し出され、短くすれば左に寄ります。
手で空白を足して直すこともできますが、列が多いと全行を数え直すことになります。

このツールなら、ずれた表を右側の欄に貼ると、左側の欄に表計算向けの形で中身が出ます。
書き換えは左側で行うと、桁を揃え直したMarkdownが右側に出ます。
表計算ソフトへ戻さなくても、ツールの中で直して揃え直せます。