表計算データをMarkdown表にするメリット
ExcelやGoogleスプレッドシートの表を、ブログ記事(Qiita・Zenn・はてなブログ)やGitHubのREADME・Issue・Pull Requestに載せるには、Markdownの表の記法(| や ---)で書き直す必要があります。
手で打ち込むと手間がかかり、列の数を間違えるなどのミスも出やすい作業です。
このツールなら、表計算ソフトでセル範囲を選んでコピー(Ctrl+C)し、入力欄に貼り付けるだけで、その場でMarkdownの表ができます。
日本語の表データをきれいに整形して桁を揃える
等幅フォントで見ると、日本語の全角文字は半角文字2文字分の幅になります。
文字数だけを数えて空白を入れると、日本語を含む列で縦線(|)の位置がずれ、ソースが読みにくくなります。
このツールは全角文字を幅2として数え、空白の数を調整して桁を揃えます。
「桁を揃える」は最初からオンになっているので、日本語の混ざった表でも、エディタで開いたときに縦線が揃います。
変換時の操作手順
- ExcelやGoogleスプレッドシートなどの表計算ソフトを開き、変換したい表のセル範囲を選択します。
- 選択範囲をコピーします(ショートカットキー: Ctrl + C または Cmd + C)。
- 本ページの「表計算データ / 区切りテキスト」の欄をクリックし、貼り付けます(ショートカットキー: Ctrl + V または Cmd + V)。
- 「Markdown表」の欄に変換結果が出るので、「Markdown表をコピー」ボタンでコピーします。
- ブログエディタやGitHubの入力画面等にそのまま貼り付けて利用します。
CSVやTSVのテキストを貼るとき
表計算ソフトからのコピーのほかに、CSVファイルやTSVファイルの中身をそのまま貼ることもできます。
区切り文字が「自動判定」のときは、先頭の数行を見て、どの行にも同じ数だけ入っている区切り文字を選びます。
選ばれた区切り文字は「判定結果: カンマ」のように表示されるので、外れていたら「区切り文字」で直接指定してください。
行によって列の数が違うときは、「列数が揃っていない行がありました(自動で空欄を補完しました)。」と表示して、足りないセルを空欄で埋めます。
※CSVを貼ったあとに「TSVでコピー」を押すと、タブ区切りに直してからコピーします。そのままExcelに貼れば列が分かれます。
判定の順番などは「Excelやスプレッドシートの表をMarkdownに貼る方法」に書いています。
Excel から持ってこられないもの
- 太字や文字色、リンク、セルの結合は引き継がれません。Excel のコピーで渡されるのは文字だけで、結合したセルは左上のセルに値が入り、残りは空欄になります
- セルの前後の空白は取り除きます
- 桁揃えでは、漢字・ひらがな・カタカナ・全角の英数字と、😀 のような絵文字を幅2、それ以外を幅1として数えます。「①」「→」のような記号は幅1として数えるので、フォントによっては列がずれます
変換の例
Excel で次の範囲をコピーして貼り付けた場合です(「箱入り」のセルは、セルの中で改行しています)。区切り文字は「自動判定」のままです。
商品 価格 備考
りんご 120 青森産
みかん 98 箱入り
10個次の Markdown になります。
| 商品 | 価格 | 備考 | | ------ | ---- | -------------- | | りんご | 120 | 青森産 | | みかん | 98 | 箱入り<br>10個 |
セルの中の改行は「<br>」に置き換わります。