Excelの表をMarkdown変換|貼り付けが崩れる原因と対処

公開ツール表を貼り付け → Markdown変換

目次
  1. 表を貼り付けると改行だけになって崩れるのはなぜか
  2. 確認する方法: Markdownの表文法に自分で書き換える
  3. よくつまずくポイント
  4. まとめ
  5. よくある質問

ExcelやGoogleスプレッドシートで表をコピーして、GitHubのREADMEやNotionのページにそのまま貼り付けたら、表の形にならず改行だけが残って列の区切りが消えていた——そんな経験があるのではないでしょうか。これは貼り付けのミスではなく、Markdownが表を表現する仕組みそのものがExcelと違うからです。原理が分かれば、毎回手作業で整え直さなくても表をそのまま移せます。

まとめ ① Markdownは表をパイプ(|)記号と、ヘッダーの下の区切り線(---)で表現する独自の文法を使います ② Excel・Googleスプレッドシートからコピーしたデータは、タブで列を区切ったプレーンテキストなので、この文法が含まれていません ③ 各列にパイプを入れ、ヘッダーの下に区切り線を入れる。この2つだけ守れば表はそのまま生き残ります

表を貼り付けると改行だけになって崩れるのはなぜか

ExcelやGoogleスプレッドシートでセル範囲をコピーすると、クリップボードには各列がタブ(Tab)文字、各行が改行文字で区切られたプレーンテキストが入ります。画面上は表に見えても、実際には目に見える文字と目に見えないタブ文字だけの普通のテキストです。

Markdownはこのテキストを表として認識しません。Markdownで表を作るには、各列の間にパイプ(|)記号を入れ、ヘッダーのすぐ下の行に |---|---| のような区切り線を必ず入れる必要があります。この2つの文法がないと、レンダラーはただの普通の段落として処理します。

そのため、GitHubのREADMEやMarkdownの編集画面にタブ区切りのテキストをそのまま貼り付けると、パイプも区切り線もないので表として描画されません。代わりに改行だけが残り、列の間のタブ文字は画面上では半角スペース1つ程度につぶれて、文字が延々とつながったように見えます。

Notionは空のページに直接貼り付けるときはタブ区切りのデータを自動で表ブロックとして認識してくれますが、すでに作られたテキストブロックの中やMarkdownソース表示に貼り付けると、同じ原理でタブ文字がそのまま残って表が崩れます。

確認する方法: Markdownの表文法に自分で書き換える

表が何行・何列かをまず確認してから、1行目(ヘッダー)を書き換えます。各列の値の前後にパイプを入れて「| 名前 | 点数 |」の形にします。

ヘッダーのすぐ次の行には、列の数だけダッシュ(---)をパイプでつないで区切り線を入れます。列が2つなら |---|---|、3つなら |---|---|---| です。この区切り線があってこそ、Markdownは1行目をヘッダーとして認識します。

残りの行も同じように、列と列の間にパイプを入れてつないでいきます。表の中にもともとパイプ(|)文字があった場合は、前にバックスラッシュを付けないと区切り線と誤認されます。この作業を表の大きさの分だけ手で繰り返すことになります。

無料ツールで確認する。 コピーした表を貼り付けるだけで、タブをパイプに置き換え、区切り線を自動で入れて、Markdownの表とHTMLの表に同時に変換してくれます。

表を貼り付け → Markdown変換

無料・登録不要・貼り付けるだけでMarkdownの表が完成

よくつまずくポイント

状況原因と対処
タブではなくカンマで区切られたデータを貼り付けた区切り文字をカンマ(CSV)に指定しないと、列が正しく分かれません
セル内に改行(Alt+Enter)がある場合表の文法では1行が1行分に対応するため崩れます。改行をスペースに置き換える必要があります
セル内にパイプ()文字がある場合
ヘッダーがなくデータだけの表1行目をヘッダーとして使うかどうかを指定しないと、ヘッダーの位置が正しく埋まりません

表からも分かるとおり、表が崩れる原因はほとんど「区切り文字が何か」と「セル内に特殊文字があるか」の2つに絞られます。貼り付ける前にこの2つだけ確認すれば、変換のミスを大きく減らせます。

まとめ

Markdownは表をパイプと区切り線で表現する独自の文法であり、Excel・Googleスプレッドシートからコピーしたデータはタブで区切られたプレーンテキストなので、この文法が欠けていて表の形が崩れます。各列にパイプを入れ、ヘッダーの下に区切り線を入れる。この2つのルールさえ守れば、どんな表でもそのまま移せます。

毎回手でパイプを入れる代わりに、貼り付けるだけで自動変換してくれるツールを使えば、表が大きいほど多くの時間を節約できます。

表を貼り付け → Markdown変換

無料・登録不要・貼り付けるだけでMarkdownの表が完成

よくある質問

Notionでは表が自動でできるのに、なぜGitHubではできないのですか?

Notionには、空のページにタブ区切りのテキストを貼り付けると、それを認識して独自の表ブロックに自動変換してくれる機能があります。一方、GitHubのREADMEや一般的なMarkdownエディターはファイル内の文字をそのまま保存するだけなので、パイプと区切り線を自分で書き込まないと表として表示されません。

セルの中に改行が入っているとどうなりますか?

Markdownの表は1行が1行分に対応する構造なので、セルの中に改行があるとその地点で行が途切れてしまいます。改行をスペースに置き換えて1行にまとめれば、表の構造を保てます。

Markdownの表ではなくHTMLの表を使うべきなのはどんなときですか?

セルの結合やセル内の書式など、Markdownの表だけでは表現できない構成が必要なときはHTMLの表タグが必要です。単純にテキストを並べるだけなら、ソースコードがより短く読みやすいMarkdownの表で十分です。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. ガントチャートとカレンダーの違い|期間と重なりが棒で見えるカレンダーでは見えない期間の長さや日程の重なりを、ガントチャートが棒の位置と長さで示す仕組みを解説。計算式と手書きの手順、進捗率の表し方までまとめました。
  2. HTML表のMarkdown変換で先頭列が消える原因と対処Wikipediaや公共データの表をそのままMarkdownに変換すると、先頭のセルが消えたり値が1列ずつずれる原因を変換ルールから説明し、貼り付け前に元のコードで確認する方法をまとめます。
  3. HTMLマークダウン変換で失われる書式と確認ポイントHTMLをマークダウンに変換すると、結合した表のセルや文字色など、対応する文法がない書式は消えます。その構造的な理由と、変換後に見ておきたい確認点をまとめました。
  4. icsファイルとは|中身の構造と時間ズレの見分け方.icsはメモ帳で開けるUTF-8のテキストファイルです。BEGIN:VEVENT・DTSTARTの読み方、時間帯の3つの表記、終日予定が1日ずれて見える理由を整理しました。
  5. JSONエクセル変換で空白になる原因と変換前の確認方法JSONをエクセルに変換したときセルが空になる2つの原因(キー欠落とネストした値)を実際の動作で確かめ、変換前にブラウザのコンソールで確認する方法をまとめます。
  6. JSON YAMLの違い|インデント規則とよくある失敗JSONは括弧とカンマ、YAMLはインデントでデータの境界を示します。両者の構文の違い、設定ファイルでYAMLが選ばれる理由、インデントのずれでパースが壊れる例を解説します。

関連ツール