HTML表のMarkdown変換で先頭列が消える原因と対処

Wikipediaや公共データポータルの表、Excelから書き出したHTMLの表をそのままコピーしてMarkdownに変換したとき、結果がおかしくなった経験はないでしょうか。
各行的の先頭のセル——たいてい項目名が入る場所——が丸ごと空になったり、残りのセルの値が1つずつずれて最後のセルだけが空欄になったりする現象です。
元のHTMLの表のコードは問題なく見え、打ち間違いもないのに、変換結果だけがずれるため原因を探すのは簡単ではありません。この現象は変換が誤っているのではなく、表のコードの中にある1つのタグが原因で起きている、確認可能なものです。
まとめ ① この変換ツールは表の1行目だけをヘッダー行として読み、それより下のすべての行では
<td>タグだけを値として数えます。 ② 本文の行の先頭セルが<th scope="row">で書かれていると、そのセルは値として数えられず丸ごと飛ばされます。 ③ 飛ばされた分は行の先頭ではなく末尾に空のセルとして埋められるため、残りの値がすべて1つずつずれたように見えます。
問題:表をそのまま移したのに最初のセルが消える
Wikipediaの国別統計表や公共機関の比較表のように、アクセシビリティに配慮して作られた表では、各行の先頭セルに <td> ではなく <th scope="row"> を使います。スクリーンリーダーがそのセルを該当する行の見出しとして先に読み上げるための記法です。
画面上では通常、少し太字になっている程度でしか見えないため、一般のセルと目で区別できません。そのため表をコピーするときは、そのセルが <td> なのか <th> なのかを確認せずにコードをそのまま貼り付けてしまいます。
原因:変換ツールがヘッダー行と本文の行を別々に読むため
この変換ツールは、表の1行目(<tr>)では <th> と <td> を区別せず、すべてヘッダー行のセルとして読みます。一方、それより下のすべての行では <td> タグだけを値として読み、<th> はまったく数えません。
そのため、本文の行の先頭に <th scope="row"> があると、そのセルの文字は結果に現れません。足りないセルは行の先頭ではなく末尾に空のセルとして埋められるので、残りの値がすべて1つずつ左に詰められたように見えるのです。
解決:貼り付ける前に元のコードでthの位置を確認する
表を移す前に、表の上で右クリックして「検証(Inspect)」を選ぶと、開発者ツールにその <table> のコードが表示されます。1つ目の <tr> の下にある他の行の中に、<th で始まるタグがないか探します。
あれば、貼り付ける前にその <th ...> と閉じタグの </th> だけを <td>、</td> に置き換えれば済みます。中の文字はそのままにしてタグ名だけを変える程度なので、表全体を作り直す必要はありません。
当社の無料ツールで確認する。 タグを手作業で探して置き換える代わりに、表のコードをそのまま貼り付けて、変換結果で各行のセル数がヘッダー行と同じか、先頭のセルが空になっていないかを確認する方法もあります。
無料・登録不要・HTMLのtableコードをそのまま貼り付けるだけでMarkdownの表に即変換

よくつまずくポイント
| 状況 | 実際に起きること |
|---|---|
本文の行の先頭セルが <th scope="row"> で指定されている | そのセルの文字が結果から消え、残りの値が1つずつ詰められます |
rowspan でつながっていてその行にセル自体がない | 同じ理由で末尾が空のセルで埋められ、ずれて見えます |
| セルの中にパイプ記号が含まれている | 自動的にエスケープ処理され、表の区切り線と重なりません |
| 表にヘッダー行がなくデータから始まっている | 1行目がそのままヘッダー行として使われ、データの1行が誤って見出しに入ります |
まとめ
- この変換ツールは表の1行目だけをヘッダー行として読み、それより下のすべての行では
<td>タグだけを値として数えます。 - 本文の行の先頭セルが
<th scope="row">で書かれていると、そのセルは消え、残りの値が1つずつずれて見えます。 rowspanで省略されたセルも同じ仕組みで後ろのセルがずれます。- 貼り付ける前に開発者ツールで元のコードの
<thの位置を確認し、<td>に変えれば防げます。 - 変換後は、各行のセル数がヘッダー行と同じかどうかを確認する習慣が安全です。
無料・登録不要・HTMLのtableコードをそのまま貼り付けるだけでMarkdownの表に即変換
よくある質問
表をコピーしたとき、元のコードにthがあるかどうかはどうやって確認するのですか?
表があるページで表の上を右クリックし、「検証(Inspect)」を選ぶと、開発者ツールに該当する <table> のコードが表示されます。そのコードの中で、2つ目の <tr> 以降に <th で始まるタグがあるか探せば確認できます。
ExcelやGoogleスプレッドシートから書き出した表でも同じ問題は起きますか?
ExcelやGoogleスプレッドシートを「Webページとして保存」して書き出した表は、ほとんどの場合すべてのセルを <td> だけで書いています。本文の行に <th> が混ざるのは、主にWikipediaや公共機関の統計表のように、アクセシビリティに配慮して手作業でマークアップした表でよく見られます。
colspan・rowspanで結合されたセルも、このツールが分割して復元してくれますか?
いいえ。結合されたセルは文字が1つのセルに入るだけで、残りのセルは自動的に埋められたり切り捨てられたりします。Markdownの表の文法ではセルの結合を表現できないため、元の表であらかじめ結合を解除してから貼り付ける必要があります。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む