CSVをMarkdownの表に変換
Markdownの表を手で入力すると、1行ごとにパイプやハイフンを数えることになります。CSVをアップロードすれば、ヘッダー行と区切り行の付いた表ができあがり、README、Wikiページ、ノートブックにそのまま貼り付けられます。
データ変換
またはCSV, TSV, TXT … ファイルをここにドロップ ·
1ファイルあたり最大95 MB· 最大20ファイルまで· 30分後に削除
ファイルは当社のサーバーで処理され、30分後に削除されます。
CSVやテキストファイルで列を区切る文字です。読み込みと書き出しの両方に使われます。自動は入力から判別し、書き出しはカンマにします。
UTF-8はあらゆる言語に対応します。WindowsのExcelでCSVを開いたときにアクセント文字や日本語などが文字化けする場合は、BOM付きUTF-8を選んでください。
Excel、ODS、Numbersの入力用です。最初のシートだけ、またはすべてのシートを変換します(CSVはシートごとに1ファイルをZIPにまとめ、JSONはシートごとに1つのキーになります)。
新しいスプレッドシートのシートタブの名前です。31文字までです。
オブジェクトの配列は、各行で列名をキーにします。配列の配列はよりコンパクトで、ヘッダーを最初の配列として保持します。
すべての行を囲む外側の要素の名前です。各行はその中で<row>になります。
CREATE TABLE文とINSERT文で使われます。英字、数字、アンダースコアのみ使えます。
引用符の付け方や列の型はデータベースごとに少しずつ異なります。インポート先に合わせて選んでください。
日付のセルを1つの形式に書き換えます。ISO(2026-10-18)はデータベースやコードに最も安全です。そのままは元の表記を保ちます。
このツールの使い方
- 1
CSVをアップロード
.csv、.tsv、区切り文字付きの .txt ファイルを追加します。一度に最大20ファイル、1ファイルあたり95 MBまで対応しています。自動検出でカンマ、セミコロン、タブ、パイプの区切りを判別します。
- 2
ヘッダー行を確認
1行目を見出しにするがオンになっているため、1行目が表の見出しになります。ファイルの先頭からデータが始まる場合は、詳細設定でオフにしてください。
- 3
変換して貼り付け
Markdown表に変換を押して .md ファイルを開き、表を README、プルリクエスト、issue、ノートなどに貼り付けます。
CSV ファイルを Markdown の表に変換するには?
CSV をアップロードしてMarkdown表に変換を押します。1行目が表の見出しになり、その下にハイフンの行が追加され、残りの各行はパイプで区切ったセルの行になります。
開発者がCSVをMarkdownに変換する理由
ドキュメントは Markdown ファイルに書かれることが増えています。メンテナーは README にサポート対象バージョンの表を載せたく、エンジニアはベンチマークの数値をプルリクエストに貼り付け、研究者は Obsidian に読書リストを置きます。数値の元はたいてい表計算ソフトやスクリプトが出力した CSV で、セルごとにパイプを入れて手で作り直すのは時間がかかり、間違いも起こりやすい作業です。
2004年に John Gruber が作った元の Markdown には、表の記法がありませんでした。パイプ記法は PHP Markdown Extra を通じて広まり、2017年に GitHub Flavored Markdown の仕様に明記されました。そのため GitHub や、これに準拠する多くのツールで使えます。Excel の行を変換したい場合は、先にExcel を CSV に変換で保存してから、こちらで変換してください。
CSVからMarkdownの表への変換例
ランタイム,バージョン,状態 Python,3.13,サポート中 Python,3.9,サポート終了 | 2025年10月 Node.js,22,サポート中
| ランタイム | バージョン | 状態 | | --- | --- | --- | | Python | 3.13 | サポート中 | | Python | 3.9 | サポート終了 \| 2025年10月 | | Node.js | 22 | サポート中 |
変換したMarkdownの表が表示される場所
| 機関 | 要件 | 出典 |
|---|---|---|
| GitHub | GFM 仕様に従い、README、issue、プルリクエスト、Wiki でパイプ表を表示します。 | GFM 仕様 |
| GitLab | GitLab Flavored Markdown は、リポジトリ、issue、マージリクエストで同じパイプ表を表示します。 | — |
| Obsidian | 閲覧ビューでパイプ表を表示し、ライブプレビューでは表の編集もできます。 | — |
| Jupyter | ノートブックの Markdown セルで、コードと並べてパイプ表を表示します。 | — |
| CommonMark | コア仕様には表の記法がありません。表を扱うには、レンダラー側に表の拡張が必要です。 | commonmark.org |
CSVとMarkdownの形式の基本情報
CSV
CSV(カンマ区切り値)
CSV は表形式のデータをプレーンテキストで表す形式で、1行が1つの行にあたり、列はカンマで区切ります。コンピューターの初期から使われており、RFC 4180 に記述がありますが、セミコロンやタブで区切る変種や、異なる文字コードを使うものも多くあります。ほとんどの表計算ソフト、データベース、分析ツールで読み込みと書き出しができるため、システム間でデータをやり取りする際の標準的な形式です。CSV に保存されるのは値だけで、数式、書式、複数のシート、データ型は含まれません。
- 圧縮方式
- –
- 透過
- –
- アニメーション
- –
- 登場時期
- –
MD
Markdown
Markdownは、2004年にJohn Gruberが作った軽量マークアップ記法です。見出しの#、強調の*、リストの-など、プレーンテキストの記号を使い、そのままでも読みやすく、きれいにHTMLへ変換できます。READMEファイル、ドキュメント、Wiki、ノートアプリ、多くの静的サイトジェネレーターの標準です。CommonMarkやGitHub Flavored Markdownなど複数の方言があり、表などの細部が異なります。.mdファイルはどのテキストエディタでも開けます。
- 圧縮方式
- –
- 透過
- –
- アニメーション
- –
- 登場時期
- 2004 · John Gruber
小さなデータをドキュメントに載せたいときに、CSV を Markdown に変換します。たとえば README の互換性表、変更履歴のバージョン一覧、ベンチマーク結果を比較するプルリクエスト、個人用ナレッジベースのメモなどです。
値についてはほぼ損失なく変換できますが、データの意図までは引き継げません。CSV はソフトウェアが読めるようにすべての行を保持しますが、Markdown の表は人が見るためのデータの見せ方にすぎず、型も数式もセル結合もありません。元データとして CSV をリポジトリに残し、数値が変わったら表を作り直してください。
CSVのMarkdown変換に関するよくある質問
Markdownの表はどこで表示されますか？
パイプ表の拡張に対応しているレンダラーなら表示されます。GitHub、GitLab、Obsidian、Jupyter ノートブック、MkDocs や Hugo などの静的サイトジェネレーターが該当します。厳密な CommonMark のレンダラーでは、同じ行がパイプ付きのプレーンテキストとして表示されます。
CSVの値にパイプ文字が含まれている場合はどうなりますか？
エスケープしていない | は新しいセルの開始と見なされ、それ以降の列がすべて右にずれてしまいます。変換時には GitHub Flavored Markdown が定めるエスケープの \| に書き換えるので、パイプはセル内の文字として表示されます。
数値を右揃えにできますか？
はい、区切り行を編集すれば指定できます。---: で右揃え、:---: で中央揃え、:--- で左揃えになります。コロンは変換後に追加してください。表示のされ方が変わるだけで、データ自体は変わりません。
Markdownの表にするのに適したCSVの大きさは？
Markdown の表は読むためのものなので、数十行程度、数列程度に収めるのが最適です。数千行の表も変換はできますが、README がスクロールしにくくなります。その場合はリポジトリ内の CSV ファイルへのリンクを置き、サンプルだけを表示してください。
CSVのフィールド内の改行はどうなりますか？
Markdown の表の行は1行に収める必要があるため、引用符で囲まれた複数行の CSV の値はそのままでは保持できません。変換前に改行を置き換えてください。GitHub ではセル内に <br> を入れると改行できます。
表をHTMLに変換することもできますか？
出力先が Markdown ファイルではなく、Web ページ、CMS、メールの場合は、変換先を HTML table に設定してください。元のデータが JSON の場合は、その出力があらかじめ選択されているJSON から HTML への変換ページをご利用ください。