Markdown Table vs CSV の使い分けと相互変換（GitHub・Pandas・Excel）

ドキュメント作成時の Markdown 表（パイプ | 表記）と CSV（カンマ区切り）の比較、用途に応じた選択基準、および自動変換コードです。

1. オンライン Markdown 表生成 ＆ CSV 変換ツール

CSVの貼り付けやExcelからのコピペで Markdown 表を即座に作成・編集できます。

---

2. Markdown Table vs CSV 仕様比較表

比較項目	Markdown Table (|)	CSV (Comma-Separated Values)
主な用途	GitHub README, Notion, Qiita, 社内ドキュメント	Excel, データベースインポート, Python (Pandas)
可読性 (生テキスト)	高い (視覚的に列が揃う)	低い (長文やカンマ混在時に見づらい)
プログラミング処理	扱いづらい (パーサーが必要)	極めて容易 (標準ライブラリでパース可能)
改行・エスケープ	セル内改行は <br /> を使う必要あり	ダブルクォート " で囲めばセル内改行可能
ファイルサイズ	パイプや余白スペース分大きい	最小のデータサイズ

---

3. 使い分けの判断基準

1. Markdown Table を選ぶべきケース:
   • GitHub / GitLab の README.md や PR の説明欄に表示したいとき。
   • 10行×5列程度までの比較表や仕様一覧。
2. CSV を選ぶべきケース:
   • 100行を超える大容量データやログ。
   • 今後 Excel や Google スプレッドシートでグラフ化・集計する可能性があるデータ。

---

4. Python で CSV を Markdown Table に変換するスクリプト

pandas を使うと1行で変換できます。

import pandas as pd

# CSV ファイルの読み込み
df = pd.read_csv('data.csv')

# Markdown 表として出力
markdown_table = df.to_markdown(index=False)
print(markdown_table)

// Node.js で CSV 文字列を簡易 Markdown 表に変換するコード
function csvToMarkdown(csvText) {
  const lines = csvText.trim().split('\n');
  const rows = lines.map(line => line.split(',').map(cell => cell.trim()));
  
  if (rows.length === 0) return '';
  
  const header = `| ${rows[0].join(' | ')} |`;
  const separator = `| ${rows[0].map(() => '---').join(' | ')} |`;
  const body = rows.slice(1).map(row => `| ${row.join(' | ')} |`).join('\n');
  
  return `${header}\n${separator}\n${body}`;
}