CSV → Markdown テーブル
CSVをMarkdownテーブルに即座に変換。引用符フィールド対応、1 行目をヘッダーとして処理、左/中央/右揃え選択可能。ブラウザ内で処理、データ送信なし。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
Markdownテーブルの構文
Markdownテーブルはヘッダー行・区切り行・データ行で構成され、パイプ文字(|)で列を区切ります。
| Name | Age | City |
| :---- | :-- | :------- |
| Alice | 30 | New York |
| Bob | 25 | London |
区切り行で配置を制御します::--- = 左揃え、:---: = 中央揃え、---: = 右揃え。
料金表を右揃えで作る
金額の列を右に寄せたい料金表です。桁区切りのカンマを含む金額は、引用符で囲んでおきます(例のプランと金額は架空のものです)。
プラン,月額(円),ストレージ
ライト,"1,980",100GB
スタンダード,"3,980",1TB
プレミアム,"7,980",
| プラン | 月額(円) | ストレージ |
| -------: | ------: | ------: |
| ライト | 1,980 | 100GB |
| スタンダード | 3,980 | 1TB |
| プレミアム | 7,980 | |
- 引用符は外れ、
1,980のカンマはセルの中に残ります。引用符で囲まないと、1と980が別の列に分かれます。 - 配置は全列共通なので、プラン名も右揃えになります。金額の列だけ右揃えにしたいときは、コピー後に区切り行を
| :--- | ---: | :--- |のように書き換えます。 - 最後の行はストレージが空なので、空のセルになります。
- 列の幅は文字数で数えて空白を足しています。全角文字は等幅フォントで 2 文字分の幅なので、ソース上では列がずれて見えますが、表示される表には影響しません。
英数字のデータと引用符
区切り文字を含む値や、セル内のパイプの扱いは次のとおりです(配置は「右揃え」)。
product,price,units
Widget,9.99,150
"Gadget, large",24.99,42
Cmd|Ctrl+C,1,2
| product | price | units |
| --------------: | ------: | ------: |
| Widget | 9.99 | 150 |
| Gadget, large | 24.99 | 42 |
| Cmd\|Ctrl+C | 1 | 2 |
値の中の | は \| と書き出されるので、列の区切りになりません。区切り行はほかの行より幅が広くなりますが、レンダラーはこの幅の違いを無視するので、表は正しく表示されます。
全角カンマに注意
IME をオンにしたまま入力すると、カンマが全角(,)になることがあります。全角カンマは区切り文字ではありません。
品名,数量
ノート,3
| 品名,数量 |
| :------ |
| ノート,3 |
行全体が 1 つのセルになりました。Excel や Google スプレッドシートからコピーしたテキストもタブ区切りなので、同じく 1 列になります。先に半角カンマへ置き換えるか、カンマ区切りの CSV として保存してから貼り付けてください。
パイプと引用符
2 行目のパイプはすでにエスケープ済みで、3 行目はフィールドの途中にインチ記号があります。
書き方,意味
a|b,a または b
a\|b,エスケープ済み
5" パイプ,インチ記号
| 書き方 | 意味 |
| :------- | :-------- |
| a\|b | a または b |
| a\|b | エスケープ済み |
| 5" パイプ | インチ記号 |
ただの | にはバックスラッシュが付き、もともと \| だったものはそのままなので、どちらの行も a|b と表示され、セルは分かれません。5 のあとの " はフィールドの先頭ではないので、文字としてセルに残ります。
Qiita や Zenn で使う
GitHub と GitLab では、README、Issue、プルリクエスト、Wiki でこの表の書き方が表示されます(GFM 仕様:表)。Qiita の Markdown 記法と Zenn の Markdown 記法にも同じ形の表が載っています。表は拡張構文なので、拡張なしの CommonMark ではただのテキストになります。JSON が必要な場合は CSV JSON 変換器を使ってください。
制限事項
- 区切り文字は半角カンマだけ。 タブ・セミコロン・全角カンマは区切りになりません。地域によってはセミコロン区切りの CSV もあり、これも 1 列になります。
- ヘッダーより長い行があれば列を足します。 列数はいちばん長い行に合わせます。ヘッダーのない列は位置から
Column N(4 列目ならColumn 4)と名付け、ステータス行に表示します。項目が少ない行は空のセルで埋めます。 - 配置は全列共通。 上の料金表のように、列ごとの配置はコピー後に区切り行で調整します。
- セル内の改行はスペースになります。 Markdown の表のセルには改行を入れられません。HTML が使えるレンダラーなら手で
<br>を書きます。 - 書式は変換しません。 セルの文字はそのまま出力されるので、
*や_が Markdown の強調として解釈されることがあります。 - パイプは Markdown 表作成ツールと同じ規則でエスケープします。 直前のバックスラッシュが偶数個のパイプにだけバックスラッシュを足すので、セルにもともと
\|があれば\|のまま出力され、表示は|になります。バックスラッシュ自体を表示したいときは CSV に\\|と書きます。GitHub でも micromark 系のレンダラー(remark、MDX、Astro)でもセルは分かれません。 - 引用符として扱うのはフィールド先頭のダブルクォートだけです。 引用符のないフィールドの途中にある
"はただの文字で、5" パイプはそのまま残ります。閉じられていない引用符があると変換を止め、引用符が始まる行をエラーで示します。
FAQ
どのような CSV 形式に対応していますか?
カンマ区切りで、RFC 4180 の引用符ルールに沿った CSV です。引用符付きフィールドにはカンマ・改行・2 つ重ねたダブルクォート("")を含められます。行末は LF・CRLF・CR のどれでもよく、先頭の UTF-8 BOM は取り除きます。タブやセミコロンは区切り文字になりません。
列の配置はどのように機能しますか?
左揃え・中央揃え・右揃えはいつでも切り替えられ、今の表がすぐに作り直されます。区切り行は全列に :---、:---:、---: のどれかを書き、Markdown のレンダラーがそれを見てセルを揃えます。列ごとに変えたいときは、コピーしてから区切り行を書き換えます。
1 行目がヘッダーになりますか?
はい。1 行目は常にヘッダーとして区切り行の上に置きます。後の行にヘッダーより多い項目があると、位置に応じて Column N という列を追加し、ステータスに表示します。
データはサーバーに送信されますか?
いいえ。表はブラウザのタブの中で作られ、CSV はサーバーに送信されず、ブラウザのストレージにも保存されません。入力欄の編集を終えてフォーカスが外れたときと、配置を選んだときに、ページのアクセス解析が利用イベントを 1 回記録します(ツール名と動作 convert のみで、CSV や表の内容は含みません)。
GitHub や GitLab にそのまま貼り付けられますか?
はい。出力は GitHub Flavored Markdown(GFM)の表の書き方で、GitHub と GitLab の README、Issue、プルリクエスト、Wiki で表示されます。表の拡張に対応していないレンダラーでは、ただのテキストとして表示されます。