Excelやスプレッドシートの表をMarkdownに貼る方法
Markdown表・表データ変換コラム
執筆:松村 誠(植木鉢団 代表)
記事やREADMEに載せる表を、いちいち手で組み直すのは面倒です。
元の表がある以上、変換で済ませたいところです。
コピーしたデータの正体はタブ区切り
Excelやスプレッドシートでセル範囲を選んでコピーすると、クリップボードにはタブで区切られたテキストが入っています。
セルの区切りがタブ、行の区切りが改行です。
つまり、コピーした時点で「表の構造を持ったテキスト」になっているので、あとは | の形に組み替えるだけで変換できます。
メモ帳に貼ってみると、この状態が確認できます。
一見きれいに並んで見えるのは、タブ幅で桁が揃っているからです。
変換の手順
- 表計算ソフトで、ヘッダを含めて範囲を選択してコピー
- 変換ツールの左側の欄に貼り付け
- 右側に出てきた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やスプレッドシートに戻す」のコラムで書いています。
セルの中に改行や | が入っている場合の扱いは、「セルの中に改行・パイプ・カンマがあるときの書き方」のコラムを参照してください。