CSV to Markdown — CSV データを Markdown テーブルに変換
CSV データを Markdown テーブル記法に変換し、README やドキュメント、ブログ記事に使えるようにします。パイプ整列の出力、ブラウザだけで動作。アップロード不要、制限なし。
CSV to Markdown Table
Convert CSV or tab-separated data to a formatted Markdown table. Auto-detects delimiter (comma, tab, semicolon) and aligns columns. Perfect for README files, GitHub issues, and documentation. Works entirely in your browser.
CSV to Markdown は、出力先がドキュメント サイト、README、ブログ記事、その他テキスト主体のサーフェスである場合に適した変換です。Markdown テーブルには特有の記法があります。pipe 区切りの値のヘッダー行、コロンで揃えを指定する区切り行、ヘッダーと同じ列数のデータ行、という構成で、整形済みのテーブルはあらゆる GitHub Flavored Markdown レンダラーで適切に整列された HTML テーブルとして表示されます。この変換は十分に短いので手作業でも書きたくなりますが、入力が数行を超えたあたりから揃えがずれ始め、生の状態でも表示結果でも列幅がおかしなテーブルができあがります。
Markdown テーブル生成において「当たり前ではない」のはエスケープです。pipe 文字(|)は Markdown テーブル記法におけるセル区切りなので、セル値内のあらゆる pipe はエスケープが必要です。通常は \| と書くか、バッククォートで囲みます。もう一つのエスケープ リスクは改行です。複数行のセル値(改行を内包する引用符付き CSV セル)は Markdown の単一行セル モデルに合わないため、内部の改行を <br> タグに変換するのが常套手段で、GitHub などのほとんどのレンダラーがこれを受け付けます。本ツールはこの 2 種類を自動で処理するため、出力は GFM エコシステム全体で手作業の後処理なしに直接使えます。
最終的な受け渡しについて。出力先が GitHub の README や GFM 対応ドキュメント サイトなら、出力をそのまま貼り付けてください。出力先が純粋な CommonMark レンダラー(まれです。最近のツールはほとんど GFM 対応)の場合は、HTML に変換して HTML を埋め込んでください。出力先がスプレッドシートやデータ パイプラインであれば、この変換はそもそも不適切です。同じ CSV を CSV-to-JSON や CSV-to-XML に通してください。Markdown 形式は人間が読むドキュメント用であり、機械可読なデータ交換用ではありません。
使い方
CSV データを貼り付ける
CSV を入力エリアにドロップするか、.csv ファイルを読み込みます。ツールが区切り文字(カンマ、セミコロン、タブ)と UTF-8 BOM の有無を自動検出します。複数行セルにも対応しており、引用符で囲まれたセル内の改行はそのまま保持されます。
Markdown の方言を選ぶ
標準 Markdown(GitHub、GitLab、Hugo、Jekyll で動作)、GFM(GitHub Flavored Markdown、テーブルに関しては標準と同等)、またはパイプ対応版(セル内のパイプをエスケープ)のいずれかを選択できます。
テーブルをコピーする
Markdown をクリップボードにコピーします。出力は自己完結したテーブル 1 枚で、任意の Markdown ドキュメントに貼り付けると静的サイトジェネレーターが整った HTML テーブルとしてレンダリングします。
よくある質問
どの Markdown の方言がテーブルに対応していますか?
標準 Markdown には対応していません。テーブルは GitHub Flavored Markdown(GFM)の拡張機能です。GitHub、GitLab、Bitbucket、Hugo、Jekyll、Eleventy、Obsidian、およびほとんどの静的サイトジェネレーターは GFM テーブルをサポートします。純粋な CommonMark レンダラーは生の pipe 記法を表示します。
セル内のパイプ文字はどうエスケープされますか?
セル内のパイプはデフォルトで `\|` にエスケープされ、ほとんどの Markdown レンダラーはこれをリテラルなパイプとして解釈します。もう一つの方法はセルをバッククォートで囲むことで、セル値にパイプが含まれ、かつ「バッククォートを使用」オプションが有効な場合にツールはこの方法を使います。
列の揃えを指定できますか?
はい、3 種の揃えオプションがあります。左揃え(デフォルト、`:---`)、右揃え(`---:`)、中央揃え(`:---:`)。設定パネルで列ごとに揃えを指定でき、出力の区切り行が指定に合わせて更新されます。
改行を含むセルはどうなりますか?
厳密な仕様の Markdown テーブルは複数行セルをサポートしませんが、ほとんどのレンダラー(GitHub を含む)は `<br>` タグを尊重します。ツールはセル内の改行を `<br>` タグに変換するので、GitHub や他のほとんどのレンダラーで正しく表示されます。
1 行目はヘッダーとして扱われますか?
はい。デフォルトで 1 行目がヘッダー行になり、その下に区切り行が続きます。「ヘッダーなし」オプションをオンにすると全行がデータ行としてレンダリングされます。列名を含まない純粋なデータ書き出しの CSV で便利です。
制限事項
- GFM テーブルのみ出力は GFM テーブル記法です。純粋な CommonMark レンダラー(厳密仕様)では pipe がテキストとして表示されます。CommonMark 専用の出力先には、HTML に変換して直接 HTML を埋め込んでください。
- colspan / rowspan には非対応Markdown テーブルはフラットなグリッドであり、結合セルは表現できません。入力に結合ヘッダーがある場合、出力は各セルを別個にレンダリングするため、HTML レベルの結合を追加するには Markdown を手作業で編集する必要があります。
- セル幅は自動調整されない出力の列幅は各列の最長値に基づきますが、Markdown レンダラーは空白による揃えを無視し、セルの内容で列幅を決めます。パディング付き出力は生の状態では読みやすいですが、レンダリング結果のテーブルは変わりません。
プラットフォーム別の注意点
- macOS
- GitHub Desktop と Obsidian はどちらも GFM テーブルをインラインでレンダリングします。本ツールの Markdown 出力は両方が受け付ける標準記法です。GitHub 以外の出力先では、公開前にそのレンダラーで出力結果をテストしてください。
- Windows
- Typora と VS Code の Markdown プレビューはいずれも GFM テーブルをレンダリングします。出力は両者の間でそのまま持ち運べます。Notion や Confluence を目的とする場合は、テーブルをコピーしたらそれぞれの「テーブル挿入」機能を使い、生の Markdown をそのまま貼り付けるのは避けてください。
- Linux
- Pandoc は CSV を直接 Markdown テーブルに変換できます:`pandoc input.csv -o output.md`。本ブラウザツールは単発変換や、チャット・メール・ドキュメント ページから貼り付けたコンテンツに向いています。
- Web
- 完全にクライアントサイドで動作します。ページの読み込み後はオフラインでも動作。依存関係なしで、GitHub の README、GitLab の issue、Hugo のブログ記事、Obsidian のノートなど任意の場所に貼り付けられる可搬性の高い出力です。