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

公開ツールHTMLテーブル Markdown変換器

目次
  1. 問題:表をそのまま移したのに最初のセルが消える
  2. 原因:変換ツールがヘッダー行と本文の行を別々に読むため
  3. 解決:貼り付ける前に元のコードでthの位置を確認する
  4. よくつまずくポイント
  5. まとめ
  6. よくある質問

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テーブル Markdown変換器

無料・登録不要・HTMLのtableコードをそのまま貼り付けるだけでMarkdownの表に即変換

よくつまずくポイント

状況実際に起きること
本文の行の先頭セルが <th scope="row"> で指定されているそのセルの文字が結果から消え、残りの値が1つずつ詰められます
rowspan でつながっていてその行にセル自体がない同じ理由で末尾が空のセルで埋められ、ずれて見えます
セルの中にパイプ記号が含まれている自動的にエスケープ処理され、表の区切り線と重なりません
表にヘッダー行がなくデータから始まっている1行目がそのままヘッダー行として使われ、データの1行が誤って見出しに入ります

まとめ

  • この変換ツールは表の1行目だけをヘッダー行として読み、それより下のすべての行では <td> タグだけを値として数えます。
  • 本文の行の先頭セルが <th scope="row"> で書かれていると、そのセルは消え、残りの値が1つずつずれて見えます。
  • rowspan で省略されたセルも同じ仕組みで後ろのセルがずれます。
  • 貼り付ける前に開発者ツールで元のコードの <th の位置を確認し、<td> に変えれば防げます。
  • 変換後は、各行のセル数がヘッダー行と同じかどうかを確認する習慣が安全です。
HTMLテーブル Markdown変換器

無料・登録不要・HTMLのtableコードをそのまま貼り付けるだけでMarkdownの表に即変換

よくある質問

表をコピーしたとき、元のコードにthがあるかどうかはどうやって確認するのですか?

表があるページで表の上を右クリックし、「検証(Inspect)」を選ぶと、開発者ツールに該当する <table> のコードが表示されます。そのコードの中で、2つ目の <tr> 以降に <th で始まるタグがあるか探せば確認できます。

ExcelやGoogleスプレッドシートから書き出した表でも同じ問題は起きますか?

ExcelやGoogleスプレッドシートを「Webページとして保存」して書き出した表は、ほとんどの場合すべてのセルを <td> だけで書いています。本文の行に <th> が混ざるのは、主にWikipediaや公共機関の統計表のように、アクセシビリティに配慮して手作業でマークアップした表でよく見られます。

colspan・rowspanで結合されたセルも、このツールが分割して復元してくれますか?

いいえ。結合されたセルは文字が1つのセルに入るだけで、残りのセルは自動的に埋められたり切り捨てられたりします。Markdownの表の文法ではセルの結合を表現できないため、元の表であらかじめ結合を解除してから貼り付ける必要があります。

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

関連記事

  1. HTMLマークダウン変換で失われる書式と確認ポイントHTMLをマークダウンに変換すると、結合した表のセルや文字色など、対応する文法がない書式は消えます。その構造的な理由と、変換後に見ておきたい確認点をまとめました。
  2. icsファイルとは|中身の構造と時間ズレの見分け方.icsはメモ帳で開けるUTF-8のテキストファイルです。BEGIN:VEVENT・DTSTARTの読み方、時間帯の3つの表記、終日予定が1日ずれて見える理由を整理しました。
  3. JSONエクセル変換で空白になる原因と変換前の確認方法JSONをエクセルに変換したときセルが空になる2つの原因(キー欠落とネストした値)を実際の動作で確かめ、変換前にブラウザのコンソールで確認する方法をまとめます。
  4. JSON YAMLの違い|インデント規則とよくある失敗JSONは括弧とカンマ、YAMLはインデントでデータの境界を示します。両者の構文の違い、設定ファイルでYAMLが選ばれる理由、インデントのずれでパースが壊れる例を解説します。
  5. Markdownの改行が反映されない原因と3つの対処法MarkdownでEnterを1回押しても改行が消えて文がつながる理由を、CommonMarkの仕様から説明します。空行・行末の空白2つ・breaksオプションの3つの方法で確実に改行する方法も解説します。
  6. マークダウン表の中央揃えは区切り線のコロンで決まるマークダウン表の中央・右揃えが、セル内の空白ではなくヘッダー下の区切り線のコロン位置で決まる仕組みを解説します。表が崩れる原因と正しい書き方もわかります。

関連ツール