Markdownで表（テーブル）を作る書き方

• 表は3段で書きます。1行目が見出し、2行目が | --- | --- | の区切り、3行目以降がデータです。
• 列の揃えは区切り行のコロンです。:--- は左、:---: は中央、---: は右です。
• そのまま貼っても表になりません。セルの途中で改行した行や、Excelからコピーしただけの文字には、区切り行がありません。

基本の早見表

表はCommonMarkの基本記法にはなく、GitHub Flavored Markdown（GFM）の表などの拡張です。対応している表示先では、次の3行が最小の表になります。

| 項目 | 数量 |
| --- | --- |
| 用紙 | 100 |
| 封筒 | 20 |

上の入力は、対応する表示では次のような表になります。

• 区切り行の列数は、見出し行の列数と揃えます。違うと、このサイトの変換では表になりません。
• データの行は、セルが足りないと空欄になり、多いセルは無視されます。
• 左右の | はGFMでは省略できます。この記事の例では、列の境目が見えるように付けています。
• 見出しと区切りのあいだ、区切りとデータのあいだには空行を入れません。空行があると、そこで表が終わります。
• セルの中の | は \| と書きます。書かないと、その位置で列が分かれます。

記号の一覧はMarkdown記法チートシート、表が拡張記法である理由はMarkdownとはでも扱っています。

列の揃え（:--- など）

揃えは、区切りセルのコロンの位置で指定します。ハイフンだけの --- も左揃えです。コロンを付けると、左・中央・右を明示できます。

数量だけ右、メモは中央、という表は次のように書きます。

| 項目 | 数量 | メモ |
| :--- | ---: | :---: |
| 用紙 | 100 | 在庫 |
| 封筒 | 20 | 予備 |

揃えが反映されたときの見本です。表示先のCSSが左揃えを指定していると、この見た目にはなりません。

2026年11月9日に、このサイトのMarkdown → HTMLが読み込む変換で、上の3列の例を確認しました。:--- は align="left"、---: は align="right"、:---: は align="center" になりました。ハイフンだけの --- も表になり、その列には align 属性が付きません。「CSSを埋め込む」は初期状態でオンです。そのCSSは th と td を左揃えにしているので、プレビューの見た目だけではコロンが効いたか判断できません。HTMLコードの align を見るか、「CSSを埋め込む」をオフにしてプレビューしてください。

セルの改行と、表でできないこと

表の1行は、原稿の1行です。セルの途中でEnterを押すと、そこから先は次の行になり、空のセルができます。セルの中で改行したいときに空行を入れると、表そのものが終わります。

| 項目 | 内容 |
| --- | --- |
| 住所 | 東京都<br>千代田区 |

HTMLを通す表示先では、<br> がセルの中の改行になります。通さない表示先では、タグが文字のまま残るか、削除されます。段落の改行との違いは、Markdownで改行されない原因と改行の書き方にまとめています。自動改行のオプションをオンにしても、セル途中のEnterは <br> にはなりません。

• セルの結合（横方向・縦方向）は書けません。結合していた内容は、必要なセルへ文字を分けます。
• セルの中の箇条書きや段落は、ブロックとしては置けません。太字、リンク、コードの断片のような行内の記法は使えます。
• 見出し行を省略して、区切り行から始める書き方は、GFMの表になりません。

同じ原稿でも、表を表示しないアプリでは縦線のままです。編集アプリの差はMarkdownエディタおすすめで、渡す形式がWordならMarkdownをWord（docx）に変換する方法で、開いたあとの列を確認してください。Word側の結合セルも、Markdownの表だけでは表せません。

ExcelやCSVをMarkdownの表にする

Excelで範囲をコピーしてプレーンテキストへ貼ると、多くの場合はタブで区切られた行になります。CSVはカンマ区切りです。どちらも | と区切り行がないので、貼っただけではMarkdownの表になりません。

小さな範囲なら、次の順で書き換えられます。練習は、次のような2列で十分です。

1. 表にしたい範囲だけをコピーし、メモ帳などのプレーンテキストに貼ります。列のあいだがタブなら、そのタブを | に置き換えます。
2. 各行の先頭に | 、末尾に | を付けます。
3. 1行目が見出しになるようにします。Excelの1行目が見出しでないときは、Markdown側で見出しの行を足します。
4. 見出しの次の行に、列の数だけ | --- | を並べます。右揃えにしたい列だけ | ---: | にします。
5. セルに | があるときは \| にします。セル内の改行は、1行にまとめるか、HTMLを許可する表示先に限って <br> に置き換えます。
6. 貼り付けた結果を、使う場所のプレビューで確認します。

書き換え後の例です。

| 項目 | 数量 |
| --- | ---: |
| 用紙 | 100 |
| 封筒 | 20 |

CSVの場合も、列を | で区切り、同じ区切り行を足します。ただし、メモの中にカンマがある行は引用符で囲まれていることがあります。カンマを機械的に縦線へ替えると、その行だけ列がずれます。次のような行は、引用符の内側を一つのセルとして残します。

項目,メモ
用紙,"A4, 白"

これは次の1行にします。

| 項目 | メモ |
| --- | --- |
| 用紙 | A4, 白 |

ファイルとしてのCSVを先に作るときは、XLSX → CSVを使えます。このツールが書き出すのはCSVで、Markdownの表ではありません。文字化け、先頭のゼロ、複数シート、数式と書式は、ExcelをCSVに変換する方法で確認してから、上の手順で表にしてください。先頭のゼロは、数値のセルだと貼り付け時に消えることがあります。結合したセルは、解除してからコピーします。

表示を確認する

手元で1回見るときは、Markdown → HTMLを開きます。入力した原稿はブラウザの中で変換します。ページ表示そのものでは、ほかのページと同じように解析や広告の通信があります。顧客名や未公開の数字は、練習の入力に使わないでください。

1. この記事の基本の表を貼ります。
2. 「GFMテーブル」がオンであることを確認します。初期状態はオンです。オフにすると、同じ入力は表にならず、縦線を含む段落になります。
3. プレビューとHTMLコードを見ます。揃えを判断するときは、align属性を見るか、「CSSを埋め込む」をオフにします。

2026年11月9日に、このツールが読み込む変換と、ページに書かれているCSSで、区切り行の有無、列数の不一致、セル内の <br>、セル途中の改行、3種類のコロンを確認しました。変換ライブラリの版は変わることがあるので、納品先のプレビューも見てください。HTMLとして保存する手順は、書いたMarkdownがそのままHTMLにでも紹介しています。

よくある質問

Markdownの表は、どこでも使えますか？

表になるのは、GFMなどの拡張に対応した表示先です。CommonMarkの基本記法には表がないので、対応していない入力欄では縦線とハイフンが文字のまま残ります。渡す前に、相手のプレビューで1回確認してください。

セルの中で改行するには、どう書けばよいですか？

原稿のEnterは、その表の行の終わりです。空行を入れると表が終わります。HTMLを許可する表示先では、セルの中に <br> を書けます。許可しない表示先では、改行のない短い文にするか、内容を次の行へ分けます。段落そのものの改行は、改行の書き方を見てください。

Excelからコピーした表が、Markdownの表にならないのはなぜですか？

プレーンテキストへの貼り付け結果は、タブ区切りやカンマ区切りであることが多く、| --- | の行がありません。タブやカンマを縦線に替え、見出しの次に区切り行を足してください。セル内のカンマ、改行、|、結合セルがあると、そのままだと列がずれます。

まとめ

Markdownの表は、見出し行、ハイフンの区切り行、データの行で書きます。揃えは :---、:---:、---: です。セルの途中で改行せず、ExcelやCSVは縦線と区切り行へ直してから貼ります。結合セルは表せません。

表示の確認はMarkdown → HTMLの「GFMテーブル」でできます。あわせて、Markdownとは、改行の書き方、Wordへの変換、エディタの選び方、ExcelからCSVへの変換をご覧ください。

2026年11月9日公開。GFMの表の書き方と、このサイトのMarkdown → HTML（GFMテーブル、自動改行、CSSの埋め込み）で確認した範囲を書いています。