ViewCSVCSV ファイルを開くか貼り付けると、オプションの横にパイプ形式の表が表示され、そのまま README、Issue、Wiki ページに使えます。値の中の | は \| として書き出されるためセルが分かれることはなく、セル内の改行は <br> になり、数値の列は右揃えになります。ファイルはブラウザー内で変換され、アップロードされることはありません。
CSV を Markdown に変換する手順
- ファイルを開く を選ぶか、
.csv、.tsv、.txtファイルをツールにドロップするか、貼り付け を選びます。区切り文字は自動で判定されます。判定が誤っている場合は、読み込み設定 で区切り文字、文字コード、1 行目は列名（見出し） を設定してください。 - 列の配置 と、セル内の改行 の書き出し方を選びます。Markdown タブには、ダウンロードされるテキストそのものが表示されます。
- コピー を選んで GitHub、GitLab、エディターに表をそのまま貼り付けるか、Markdown をダウンロード を選んで
.mdファイルとして保存します。
ファイルに見出し行がない場合は、1 行目は列名（見出し） をオフにします。Markdown の表には常に見出しが必要なため、列には Column 1、Column 2 のような名前が付きます。同じデータを Web ページの表として表示したい場合は、CSV を HTML に変換 を使ってください。
各オプションの内容
| 数値は右揃え、文字列は既定 | 既定の設定です。列が右揃え（---:）になるのは、空でないすべての値が単純な数値である場合だけです。00731 や 12 kg を含む列は、表示ツールの既定の配置のままになります。 |
|---|---|
| 既定（指定なし）、左揃え、中央揃え、右揃え | すべての列に同じ配置を適用します。区切り行は、それぞれ ---、:---、:---:、---: になります。 |
| <br> として残す | セル内の改行を <br> にします。GitHub をはじめほとんどの表示ツールでは、セル内の改行として表示されます。これが既定の設定です。 |
| スペースに置き換える | HTML を除去する表示ツール向けに、各改行を 1 つのスペースにします。 |
| Markdown の記号をエスケープする | 既定でオンです。*、_、[、]、<、>、#、~、バッククォートの前にバックスラッシュを付けるため、*fast* や <b> のような値が書式や HTML にならず、入力したとおりに表示されます。セルに表示させたい Markdown が含まれている場合にだけオフにしてください。 |
| ソーステキスト上で列の幅をそろえる | 既定でオンです。セルを空白で埋めて、.md ファイルのテキストが格子状に読めるようにします。中国語、日本語、韓国語などの全角文字は 2 文字分として数えます。出力を最小にするにはオフにしてください。表示される表の見た目は変わりません。 |
扱いにくいデータの処理
- パイプとバックスラッシュは、Markdown の記号をエスケープする がオフでも常にエスケープされます（
\|、\\）。エスケープしない|は新しいセルの始まりになってしまうためです。 - 引用符で囲まれたコンマや改行は RFC 4180 に従って読み込むため、
"Cable tidy, 3-pack"は 1 つのセルのままです。改行を含んでいた値の数は、プレビューの上の通知に表示されます。 - 値は文字列として書き出されます。
00731の先頭のゼロも34.90の末尾のゼロも残り、丸めや書式の変更は一切行いません。 - 空の見出しは
Column 3、重複した見出しはname (2)になるため、すべての列に別々の見出しが付きます。 - Markdown の表示ツールはセルの前後の空白を削除します。また、表の中に箇条書きや段落は入れられないため、そのような内容は別の文書にしてください。
うまくいかない場合
- 表の後のテキストが最後の行につながってしまう。 表は空行か別のブロックの始まりでしか終わらないため、表の後に空行を 1 行入れてください。
- すべての値が 1 つの列に入っている。 区切り文字の判定が誤っています。「読み込み設定」でコンマ、セミコロン、タブ、パイプのいずれかを指定し、ファイルを開き直してください。
- **結果で * や _ の前にバックスラッシュが表示される。** エスケープを無視する表示ツールで、エスケープの記号がそのまま見えています。保護すべき書式の記号がデータにない場合は、「Markdown の記号をエスケープする」をオフにしてください。
- 改行がタグの文字のまま表示される。 表示ツールで HTML が使えません。「セル内の改行」で「スペースに置き換える」を選んでください。
制限とプライバシー
25 MB、10万行、200万セルまでのファイルは、先頭 200 行のリアルタイムのプレビュー付きで開きます。それより大きなファイルはストリーミング方式で変換します。ファイルを分割して 2 回読み込み（1 回目で列とその幅を測り、2 回目で書き出す）、ダウンロードにはファイル全体が含まれることが通知され、コピー は使えません。1 つの出力ファイルは 4 GB までです。
変換はこのタブ内のバックグラウンドのワーカーで実行されるため、ページの操作が止まることはなく、キャンセル で中止できます。CSV がサーバーに送信されることはありません。変換前に大きなファイルを確認するには、CSV ビューアー で開いてください。
例
先頭がゼロの SKU、名前の中のパイプ、引用符で囲まれたコンマ、2 行のメモを含む商品リストを、既定の設定で変換した例です。price はすべての値が数値なので右揃えになり、sku は 00731 が文字列として扱われるため右揃えになりません。
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
よくある質問
出力した表は GitHub で使えますか？
はい。GitHub Flavored Markdown のパイプ形式の表で、見出し行、配置のコロン（省略可）を含む区切り行、CSV の各行に対応する行で構成されます。GitLab、Obsidian、ほとんどの静的サイト ジェネレーターでも同じ構文を読み込めます。
ソースに `\|` と表示されるのはなぜですか？
Markdown の表では、そのままの | はセルの終わりを意味します。バックスラッシュを付けると表示ツールがパイプを文字として表示するため、Desk lamp | brass は 1 つのセルのままになります。
Markdown の表を CSV に戻せますか？
このページではできません。変換できるのは、CSV と TSV から Markdown への変換だけです。