Markdownのテーブル(表)で右寄せや中央寄せをするとき、
こんな悩みを持ったことはありませんか？
「Markdown自体も右寄せや中央寄せで書くべき？」
Markdownの内容を見た目にどこまで合わせるか
全部左寄せで書いても問題ない？
こんな感じに書いてもいい？
| a | b | c |
| :---- | ---: | :----: |
| 1 | 1 | 1 |
| 10000 | 10000 | 10000 |
これを実際に表示するとこんな感じになる。問題なし！
| a | b | c |
|---|---|---|
| 1 | 1 | 1 |
| 10000 | 10000 | 10000 |
実際の表示に合わせてこんな風に書いた方がいい？
こういう方に書いた方がいい気もする。
| a | b | c |
| :---- | ----: | :---: |
| 1 | 1 | 1 |
| 10000 | 10000 | 10000 |
これを実際に表示するとこんな感じになる。Markdownと表示が似てる！
| a | b | c |
|---|---|---|
| 1 | 1 | 1 |
| 10000 | 10000 | 10000 |
中央寄せだけど中央が存在しない場合は、さすがに妥協が必要
偶数の中に奇数とかが混じると、中央揃えできない。これが限界。
| c |
| :--: |
| 1 |
| 1000 |
これを実際に表示するとこんな感じになる。表示は完全に中央揃え！
| c |
|---|
| 1 |
| 1000 |
途中で変更されたらつらい
こんな感じで中央揃えして書いてはみたけど、
| 回答 |
| :--: |
| 〇 |
| ✕ |
| 〇 |
| ✕ |
「〇」と「✕」以外の回答が出てきたら、インデントを直さなきゃいけない？
| 回答 |
| :--------------: |
| 〇 |
| ✕ |
| 無回答 (6/4期限) |
別にそんなことはなく、これで十分対応できます。
| 回答 |
| :-: |
| 〇 |
| ✕ |
| 〇 |
| ✕ |
| 無回答 (6/4期限) |
これを実際に表示するとこんな感じ。
| 回答 |
|---|
| 〇 |
| ✕ |
| 〇 |
| ✕ |
| 無回答 (6/4期限) |
問題なし！
世界的なスタンダードはどうなってる？
以下、著名なREADME.mdのテーブルです。
"vscode-extension-samples"のREADME.md
テーブルの内容が長いので、Markdownを表で表現することは不可能ですね。
2行目のハイフンの数をヘッダに合わせることすらしていない。
| Sample | Guide on VS Code Website | API & Contribution |
| ------ | ----- | --- |
| [Webview Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/webview-sample) | [/api/extension-guides/webview](https://code.visualstudio.com/api/extension-guides/webview) | [window.createWebviewPanel](https://code.visualstudio.com/api/references/vscode-api#window.createWebviewPanel)<br>[window.registerWebviewPanelSerializer](https://code.visualstudio.com/api/references/vscode-api#window.registerWebviewPanelSerializer) |
"axios"のREADME.md
こちらは綺麗な表にしています。
| System | What is being protected | Who attacks it |
| ------------------ | ------------------------------------------- | ----------------------------------------------------------------- |
| Runtime | Applications that `import axios` | Malicious servers, network attackers, malicious application input |
| Project / SDLC | The integrity of what gets published to npm | Supply-chain attackers, phishers, malicious contributors |
"Github Ranking"のREADME.md
こちらも内容が長いですが、ヘッダと2行目は合わせています。
重要なのは、有名なランキングにも関わらず、数値を右寄せしていない。
| Ranking | Project Name | Stars | Forks | Language | Open Issues | Description | Last Commit |
| ------- | ------------ | ----- | ----- | -------- | ----------- | ----------- | ----------- |
| 1 | [build-your-own-x](https://github.com/codecrafters-io/build-your-own-x) | 511609 | 48502 | Markdown | 263 | Master programming by recreating your favorite technologies from scratch. | 2026-02-21T09:34:54Z |
GitHubによるMarkdownの解説はこうなっている
GitHubはMarkdownをこう書くと
| Left-aligned | Center-aligned | Right-aligned |
| :--- | :---: | ---: |
| git status | git status | git status |
| git diff | git diff | git diff |
以下のように表示されるよと紹介しています。
| Left-aligned | Center-aligned | Right-aligned |
|---|---|---|
| git status | git status | git status |
| git diff | git diff | git diff |
また、以下のように説明されています。
Cells can vary in width and do not need to be perfectly aligned within columns.
セルの幅はさまざまであり、列内で完全に揃っている必要はありません。
強力な補助アドオンがある
Markdown All in One
テーブルのフォーマッタを持っています。
これにフォーマットをかけると
| Left-aligned | Center-aligned | Right-aligned |
| :--- | :---: | ---: |
| git status | git status | git status |
| git diff | git diff | git diff |
このようにしてくれます。
| Left-aligned | Center-aligned | Right-aligned |
| :----------- | :------------: | ------------: |
| git status | git status | git status |
| git diff | git diff | git diff |
やっぱり、みんなそうしたいよね、という裏付けでもありますね。
Markdown Table
こちらはテーブル特化型の国産アドオンです。
これがあれば、[Tab]とかポチッと押すだけで、
隣のタブへ移動したり、そのときに以下のように自動成形してくれたりします。
| Left-aligned | Center-aligned | Right-aligned |
| :----------- | :------------: | ------------: |
| git status | git status | git status |
| git diff | git diff | git diff |
これも、やっぱりみんなそうしたいよね、という裏付けでもありますね。
筆者は、両方愛用しています。
結論
ソースコードリポジトリ
- そもそもMarkdownでテーブルを使っているところが少ない
- 右寄せや中央寄せは珍しい (GitHubで
---:で検索すれば分かる) - まずは「それってテーブルじゃないとダメ？」を考える
メモやWiki
- 使いたいときは遠慮なく
- そのときには紹介したアドオンが強力なお供になるかも知れない
おしまい。