CSV to Markdownテーブル変換 | 表計算データをそのままドキュメントへ

Excelやスプレッドシートからコピーした表を、GitHubのREADMEや技術ドキュメントに貼れるMarkdownテーブルへ変換するツール。カンマ・タブ・セミコロン・パイプの4種類の区切り文字に対応し、ダブルクォートで囲まれたフィールドも正しく解釈する。

💡 このツールについて

表をMarkdownに手で書き起こすのは地味に面倒な作業。列ごとに | を入れ、2行目に --- の区切り行を足し、列数がずれないように揃える——数行ならともかく、20行を超えると確実にどこかでパイプの数を間違える。

このツールはCSVやタブ区切りのデータを貼り付けるだけで、その整形を肩代わりする。スプレッドシートのセル範囲を選んでコピーすると、多くのアプリはタブ区切りでクリップボードに入るため、「タブ」を選べばそのまま貼り付けられる。CSVファイルをテキストエディタで開いてコピーした場合は「カンマ」、ヨーロッパ圏のCSVでよくある「セミコロン」、すでにパイプ区切りで管理しているデータには「パイプ」が使える。

セル内にカンマを含む値（例: "東京, 日本"）はダブルクォートで囲んでおけば、区切り文字とは区別して1つのセルとして扱う。値の中に | が含まれていればMarkdownの表が壊れないよう \| に自動エスケープする。「1行目をヘッダーとして使用」をオフにすると Col 1、Col 2 という汎用見出しを付け、すべての行をデータ行として出力する。

🧐 よくある質問

生成したテーブルはどこに貼れる? GitHub・GitLab・Qiita・Zenn・Notion・Obsidianなど、GitHub Flavored Markdown（GFM）のテーブル記法に対応したサービスならそのまま表示できる。

列数が行ごとに違うとどうなる? 最も列数が多い行に合わせて、足りないセルを空欄で埋める。Markdownのテーブルは全行で列数を揃える必要があるため、この正規化で表崩れを防ぐ。

Excelの表をそのまま貼れる? Excelやスプレッドシートでセル範囲をコピーすると通常タブ区切りになる。区切り文字を「タブ」にして貼り付ければ変換できる。

セル内の改行は扱える? 1行=1レコードとして解釈するため、セル内に改行を含むデータは別レコードとして分割される。改行を含むセルは事前に1行へ詰めるか、<br> に置き換えておく。

何行まで変換できる? 明確な上限は設けていないが、数千行を超えると入力欄の表示が重くなる。大きなデータは必要な範囲を切り出してから貼り付けるとよい。

📚 豆知識

Markdownのテーブル記法はMarkdown考案者John Gruberの原案には含まれておらず、後発のGitHub Flavored Markdownやphp-markdown-extraといった拡張で広まった経緯がある。そのためテーブルを使うと「素のMarkdown」では崩れることがあり、HTMLの <table> にフォールバックするツールも多い。

区切り行の --- はコロンの位置で列の寄せ方向を指定できる。:--- で左寄せ、---: で右寄せ、:---: で中央寄せになる。このツールは標準の ---（既定の左寄せ）を出力するので、寄せ方向を変えたいときは生成後にコロンを手で足すと整う。