Markdownのテーブル記法 — 書き方・整形・HTMLテーブルとの比較
Markdownでテーブルを書く機能はGitHub Flavored Markdown（GFM）の拡張で広く普及しています。コードレビュー・READMEの仕様表・技術文書などで使われますが、手書きでは桁合わせが面倒なためジェネレーターを使うと効率的です。
Markdownテーブルの記法
ヘッダー行と本文をパイプ（|）で区切り、2行目に区切り線（:---・:---:・---:）を入れます。区切り線の書き方で列の揃え方（左・中央・右）が決まります。例: | 名前 | 年齢 | |:---|---:| | 田中 | 28 | のように書きます。スペースの数は揃えなくてもレンダリングは同じですが、読みやすさのために整形するのが慣例です。
CSVからMarkdownテーブルへの変換
スプレッドシートのデータをMarkdownテーブルにするにはCSVとして書き出した後、ツールで変換するのが最速です。Markdown Table GeneratorではCSVを貼り付けるだけでMarkdown形式に変換できます。ExcelやGoogleスプレッドシートから直接コピーした値をそのまま入力欄に貼ると自動でCSV認識します。
Markdown・HTMLテーブルの使い分け
GitHubのREADMEやdocs・Zenn・Notionなどは基本的にMarkdownテーブルをサポートしています。WordPressやCMSでは場合によってHTMLテーブルが必要です。Markdown Table GeneratorはMarkdown形式とHTML形式の両方で出力できます。また、ヘッダー行・列数・行数をGUIで管理でき、手書きより素早く正確にテーブルを作れます。
テーブルのアクセシビリティ
データテーブルには適切なマークアップが重要です。HTMLテーブルではscopeやthead・thead要素でヘッダーと本文を明確にすることでスクリーンリーダーが正しく読み上げます。Markdownテーブルは自動的に1行目がヘッダーとして扱われるため、表の最初の行には必ず列名を入れるようにしましょう。