CSV→Markdown表変換

1行目は、そのまま表のヘッダーです

CSVの先頭行をMarkdown表の見出しとして使います。ヘッダーなしCSVを自動判定する機能はありません。先頭行もデータなら、その値が見出しになってしまうので、必要なら変換前にヘッダーを追加します。

セル内の「|」は、そのままだと表を壊します

Markdownでは | が列境界なので、セル内に含まれる縦棒は \| へエスケープします。セル内改行は <br> に変換します。CSVとして正しく引用されたカンマや改行を、Markdown側の都合に合わせて書き換えるわけです。

このエスケープはMarkdown用です。元CSVを書き換える処理ではないので、出力を再びCSVとして使いたい場合は元データを残してください。表示用とデータ交換用は分けて持つ方が安全です。

列数が足りない行は、空セルでそろえます

行によってセル数が違う場合は、最大列数に合わせて不足分を空欄で埋めます。Markdown表は列数が揃っている方が読みやすいので、変換後にガタつきにくくなります。ただし、元CSVの列ずれを直したことにはならない点は注意です。

行ごとの列数がズレていた場合でも見た目は整ってしまうため、「Markdownになったから元CSVも正しい」とは限りません。列ずれが疑わしいデータは、先にCSV側を検査してから変換するのが確実です。

配置指定は、全列まとめて1種類です

Left / Center / Rightは表全体へ同じ設定を使います。「1列目だけ左、数値列だけ右」のような列別設定はしません。また、数値列を見て自動で右寄せすることもありません。必要なら生成後の区切り行を手で調整できます。

例えば、こんな使い方です

検証結果CSVをGitHub Issueへ貼る、比較表をREADMEへ載せる、といった用途です。CSVはデータ交換向け、Markdown表は人が読む文書向けなので、「値を変えずに見せ方だけ変える」最後の一手として使えます。