CSVをMarkdown表に変換する方法

すぐに使える答え

CSVをMarkdown表に変換するときは、1行目をヘッダーとして扱い、ヘッダー行と区切り行の列数をそろえ、セル内にパイプ文字がある場合はエスケープします。GitHub READMEやIssueに貼る前に、必ず同じ環境でプレビューしてください。

基本例

入力CSV:

tool,problem,output
CSV Fixer,文字化け,UTF-8 BOM
JSON Doctor,parse error,行と原因

Markdown出力:

| tool | problem | output |
| --- | --- | --- |
| CSV Fixer | 文字化け | UTF-8 BOM |
| JSON Doctor | parse error | 行と原因 |

GitHubのMarkdown表は、ヘッダー行、ハイフンで作る区切り行、パイプ文字で区切るデータ行で構成されます。見た目の桁そろえは必須ではありませんが、列の構造は正しくそろえる必要があります。

実務ワークフロー

1. CSVまたはTSVデータをコピーします。
2. Markdown表生成に貼り付けます。
3. 区切り文字と列数が正しく検出されているか確認します。
4. 生成されたMarkdownをコピーします。
5. GitHub、ドキュメントツール、静的サイトでプレビューしてから公開します。

GitHub表チェックリスト

CSVとTSVの使い分け

CSVは、システムから正しくクォートされたエクスポートを使う場合に向いています。スプレッドシートからコピーする場合や、値の中にカンマが多い場合はTSVのほうが安定しやすいです。どちらの場合も、Markdownの表はカンマやタブではなくパイプ文字で列を表すため、変換後のプレビュー確認が重要です。

よくある失敗

Markdown表を使うべき場面

Markdown表は、小さな比較表、設定例、READMEの機能一覧、リリースノート、APIレスポンスの短いサンプルに向いています。大量の行、横に長いデータ、フィルタや並べ替えが必要なデータは、CSVファイルや専用の表コンポーネントに分けたほうが読者に親切です。

実務FAQ

GitHubでMarkdown表が表示されないのはなぜですか？

多くの場合、区切り行がないか、ヘッダー行と区切り行の列数が一致していません。表の前に空行を入れ、2行目に各列分の区切りセルを置いてください。

Markdown表の列幅はソース上でそろえる必要がありますか？

必須ではありません。GitHubではセルの文字数が違っていても表として表示されます。ただし、人がMarkdownを読む機会が多いREADMEでは、ある程度そろえておくとレビューしやすくなります。

セルの中にパイプ文字を入れるにはどうすればよいですか？

パイプ文字の前にバックスラッシュを追加します。コマンド例、ログ、正規表現、ラベル名を表に入れるときに特に注意してください。

CSVとTSVのどちらを貼り付けるべきですか？

スプレッドシートから直接コピーするならTSVが扱いやすいことが多いです。システムから出力されたCSVを使う場合は、値の中のカンマが正しくクォートされているか確認してください。

大きなデータセットもMarkdown表にすべきですか？

通常は避けたほうがよいです。Markdown表は短く読める要約に向いています。行数や列数が多い場合は、要点だけを表にして、完全なデータはCSVや別ページへリンクしてください。

関連ツール

• Markdown表生成: CSVやTSVをGitHub向けのMarkdown表へ変換できます。

更新日

2026-06-25