CSV から Markdown 表への変換ガイド：貼る前に縦棒を確認

Markdown の表は構文が繊細です。エスケープされていない縦棒1つ、セル内の改行1つで表全体がずれます。生成後は必ずプレビューを確認してください。

表をドキュメントに貼る

README にパラメータを並べる、ドキュメントに比較表を置く、プルリクエストにテスト結果を貼る、表計算ソフトの一部をブログに移す。区切りの行を手で書くのは遅く、列を数え間違えやすい作業です。

Excel や Numbers からコピーした内容は既定でタブ区切りなので、そのまま貼れます。CSV ファイル由来ならカンマ区切りです。どちらにも対応しているので、元に合わせて選んでください。

1行目が見出し、残りが本文で、区切りの行は自動で付きます。セルにカンマが含まれる場合はタブ区切りに切り替えてください。そのままだと列が切れます。表計算ソフトから直接コピーするとタブになり、これが最も安全です。

セル内に縦棒がある場合はバックスラッシュでエスケープしてください。そうしないと Markdown が列の境界と解釈し、行がずれます。ツールは自動で処理しないため、生成後に確認が必要です。セル内の改行も扱えないので、1行にまとめてください。

セルの結合、表の入れ子、行や列のまたぎは表現できません。長い文章も折り返されず、列幅はレンダラー次第です。複雑なレイアウトが必要なら、HTML の table か文書形式のほうが正直な選択です。

列数が揃っていないと、余分なセルは連結され、足りないセルは空のままになり、壊れて見えます。生成前に表計算ソフトで列を埋め、生成後に一度プレビューを見るほうが、後から1行ずつ直すより速いです。

列がずれるのはなぜですか

区切り記号の選択ミスがほとんどです。内容にカンマがあるのにカンマで分割しています。タブに切り替えるか、カンマを含む項目を引用符で囲み、全行の列数も確認してください。

セル内に縦棒を書きたい場合は

バックスラッシュを前に付けてください。Markdown はそれを列の境界ではなく内容として扱います。ツールは自動でエスケープしないため、コミット前に置換してください。

セルを結合できますか

できません。Markdown の表に結合やまたぎの概念がないためです。必要なら HTML の table を使うか、内容を複数の小さな表に分けてください。