Markdown 表：完全リファレンス

GFM（GitHub 風）パイプ表のすべて — 構造、整列、エスケープ、レンダリングを壊す間違い、そしてツール間で表を運ぶ方法。

基本の構文

| Column A | Column B |
|----------|----------|
| cell 1   | cell 2   |
| cell 3   | cell 4   |

3 つの部分：ヘッダー行、区切り行（最低ハイフン）、そして本文行。区切り行は必須 — なければそのテキストは表ではなく段落です。ソース内の余白は揃える必要がありません。重要なのはパイプであって列幅ではありません。先頭と末尾のパイプは任意ですが、移植性のため推奨されます。

区切り行のコロンが列の整列を決めます — :--- 左（既定）、:---: 中央、---: 右：

| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |

整列は GFM が提供する唯一のセル単位コントロールです。セル背景、結合セル、列のスパンはありません。

セルはインライン Markdown を受け付けます — 太字、斜体、インラインコード、リンク — しかしブロック要素は不可。セル内にリスト、見出し、ネストした表は置けません。各行はソース 1 行。長い改行には明示的な <br> が必要です。

表の前に空行がない — 段落に張り付いていると、ほとんどのパーサーはパイプをテキストとして扱います。
不正な区切り行 — ハイフン、コロン、パイプのみを含み、ヘッダー行とまったく同じセル数でなければなりません。
セル内のエスケープされていないパイプ — リテラルの | はセルを分割し、それ以降の列をずらします。\| とエスケープしてください。
列数の揃わない行 — GitHub は欠けた末尾セルを許容します（空として描画）が、パディングや警告を行うパーサー・コンバーターもあります。行の長さを揃えましょう。
インデントされた表 — 4 つの先頭スペースでブロック全体がコードフェンスになります。

怪しい表は表ジェネレーターに貼り付けてください — 整列とエスケープを正規の形に再正規化します。

方向	ツール	メモ
Excel / Sheets → Markdown	Excel → Markdown	キャッシュ値のみ。先頭ゼロはテキストとして保持
CSV / TSV → Markdown	CSV → Markdown	RFC-4180 完全対応：引用フィールド、途中のカンマ、複数行セル
Markdown → Excel / CSV	Markdown 表 → Excel	すべての表を検出。値はテキストとして書かれ、強制変換されません
Markdown → JSON	Markdown → JSON	ヘッダー行がキーに。型推論はオフにもできます
作成・再整形	表ジェネレーター	セルか既存の表を貼り付け。整列とエスケープを正規化

5 つともブラウザ内で動き、アップロードはありません。そして対応マトリクスが、各エクスポーターが表の整列・複数行セル・エスケープをどう扱うかを文書化しています。

GitHub は整列とインライン書式を含む GFM を完全に描画します。表の前後に空行を置いてください。
Reddit はほとんどの文脈でパイプ表に対応します（整列込み）が、引用の中では使えません。
Slack と Discord は表を描画しません — パイプがそのまま表示されます。チャット向けには Markdown → 画像ツールが共有可能な画像として描画します。

Markdown 表のセル内で改行するには？

HTML の <br> タグを使います — 2 スペースの改行ルールは表の行では機能しません。行は 1 つの長い行だからです。GitHub を含む多くのレンダラーがセル内の <br> を受け付けます。

Markdown はセル結合に対応していますか？

いいえ。GFM 表に colspan や rowspan はありません。結合データを示すには、各行で値を繰り返すか表を組み替えます。スパン持ちのソースデータから繰り返しセルを生成するプリプロセッサーもあります。

Markdown 表が描画されないのはなぜ？

三大原因：表と直前の段落を分ける空行がない、整列行が不正（パイプ・ハイフン・コロンのみで、独立した行でなければならない）、セル内のエスケープされていないパイプが行を切り分けてしまう。

Markdown 表は何列まで良いですか？

書式に上限はなく、読みやすさが決めます。だいたい 7 列を超えると、ソースの走査も描画幅も厳しくなります。表の転置や分割を検討してください。

Markdown 表は Word と Excel で正しく表示されますか？

貼り付けでは表示されません — Word と Excel には Markdown パーサーがありません。先に変換してください。構造を認識するコンバーターなら、GFM 表をヘッダー行・整列・先頭ゼロを保ったまま編集可能な Word 表や本物の .xlsx シートに変換します。