Excelやスプレッドシートの表をMarkdownに貼る方法

Markdown表・表データ変換コラム

執筆:松村 誠(植木鉢団 代表)

記事やREADMEに載せる表を、いちいち手で組み直すのは面倒です。
元の表がある以上、変換で済ませたいところです。

コピーしたデータの正体はタブ区切り

Excelやスプレッドシートでセル範囲を選んでコピーすると、クリップボードにはタブで区切られたテキストが入っています。

セルの区切りがタブ、行の区切りが改行です。
つまり、コピーした時点で「表の構造を持ったテキスト」になっているので、あとは | の形に組み替えるだけで変換できます。

メモ帳に貼ってみると、この状態が確認できます。
一見きれいに並んで見えるのは、タブ幅で桁が揃っているからです。

変換の手順

  1. 表計算ソフトで、ヘッダを含めて範囲を選択してコピー
  2. 変換ツールの左側の欄に貼り付け
  3. 右側に出てきたMarkdownをコピー

CSVで書き出して読み込ませる手もありますが、貼り付けの方が手数が少ないです。
ファイルを経由しないぶん、文字コードの心配もありません。
※ CSVファイルから始める場合、Excelで保存したCSVは環境によって Shift_JIS になるので、そこで文字化けする場合があります。

CSVやセミコロン区切りも貼れる

左側の欄には、表計算ソフトからコピーしたタブ区切りのほか、CSV(カンマ区切り)やセミコロン区切りのテキストも貼れます。

区切り文字は、先頭の5行を見て、タブ・セミコロン・カンマの順に、どの行にも同じ数だけ入っているものを選んでいます。
選ばれた区切り文字は「判定結果」に出るので、外れていたら「区切り文字」で直接指定します。

手で書いたCSVなどで、行によってセルの数が違う場合は、足りないセルを空欄で補って変換し、「列数が揃っていない行がありました(自動で空欄を補完しました)。」と表示します。

ヘッダ行の扱い

1行目を見出しとして扱うかどうかは、変換前に決めておく必要があります。

ヘッダのないデータをそのまま変換すると、1行目のデータが見出しになってしまいます。
このツールでは「1行目をヘッダとして扱う」の切り替えを用意していて、外した場合は空のヘッダ行を補う形にしています(Markdownの表はヘッダを省略できないため)。
外した場合は「Markdownの表は仕様上ヘッダ行が必要なため、空のヘッダを出力しました。」と表示されます。

数式やセルの装飾は落ちる

コピーされるのは、あくまで表示されている値です。

  • 数式 → 計算結果の値だけが入る
  • セルの色、太字、罫線 → 反映されない
  • 結合セル → 分解される(内容は左上のセルに入り、他は空欄)

このうち結合セルだけは、変換後に手直しが必要になることがあります。
Markdownの表はセル結合という概念を持っていないので、こればかりは形を変えるしかありません。

桁区切りや日付も、画面に表示されているとおりの文字で運ばれます。
Markdownに載せるだけなら問題になりませんが、表計算へ戻すと値が変わるものがあります。
Excelで試した結果は「数字が数字として戻らない」のコラムにまとめています。

非表示の行や列が混ざることがある

表計算ソフトで行や列を非表示にしていても、その範囲をまとめて選んでコピーすると、隠した部分まで一緒にコピーされることがあります。
変換すると、画面では見えていなかった行が表に入ってきます。

Excelなら、範囲を選んだあとに「検索と選択」の「条件を選択してジャンプ」から「可視セル」を選ぶと、見えているセルだけをコピーできます。
※フィルターで絞り込んだ表は、見えている行だけがコピーされることが多いです。

範囲の選び方

一度に変換できるのは、1つの表の範囲だけです。
同じシートに表が2つある場合や、複数のシートにまたがる場合は、表ごとにコピーして変換します。
2つの表をまとめて選ぶと、間にある空の行や列も含めて1つの表として扱われ、形が崩れます。

列ごと・行ごと選択してコピーした場合も、空のセルまで一緒に入り、中身のない列や行が表にできることがあります。
表の左上から右下までをドラッグで選ぶと、余計なものが入りません。

逆向きの変換と、特殊な文字

Markdownの表を表計算ソフトへ戻す手順は、「Markdownの表をExcelやスプレッドシートに戻す」のコラムで書いています。
セルの中に改行や | が入っている場合の扱いは、「セルの中に改行・パイプ・カンマがあるときの書き方」のコラムを参照してください。