マークダウン表・HTMLテーブル・JSON相互変換の仕組み

Markdownの表(パイプ記法)とHTMLの<table>タグ、JSONのオブジェクト配列は表現方法が違うだけで、含まれているデータ、つまり見出し行と値の行は同じです。この記事では、3つのフォーマットがどのような規則で対応しているのか、そして列の数が合わないときやヘッダーの区切り線がないときに実際どう処理されるのかを説明します。
まとめ ① Markdownの表の1行目は見出し行で、2行目に
-の文字があるかどうかで区切り線かどうかを判断します。 ② HTMLでは<tr>の中の<th>/<td>を、JSONでは最初のオブジェクトのキー(key)を見出し行として使います。 ③ 行ごとにセルの数が違っても、自動で空欄を埋めたり超過分を捨てたりするので、自分で合わせる必要はありません。
Markdownの表をHTML・JSONに変換するときにつまずくポイント
ブログ記事ではMarkdownの表を使ったのに、サイトにはHTMLで貼り付けなければならない、逆にAPIが返したJSON配列をドキュメント用のMarkdownの表に変換しなければならない、といった状況はよくあります。表が1つや2つなら手で移しても済みますが、行が数十を超えると、パイプ(|)の位置を数えたり<td>タグを1つずつ開いたりする作業で誤字が起きやすくなります。
3つのフォーマットを手作業で移す方法: 規則は1つだけ
3つのフォーマットはいずれも、データを「見出し行」1つと「値の行」複数に分けて表現します。フォーマット間の違いは、この2つの塊を囲む文法だけです。
- Markdown → HTML: 1行目の各セルを
<th>に、それ以降の行(区切り線の行は除く)の各セルを<td>に変え、行ごとに<tr>で囲みます。 - HTML → Markdown:
<tr>1つを1行に変え、その中の<td>/<th>の値を|で区切って並べたうえで、見出し行の次の行に|---|---|の形の区切り線を入れます。 - JSON → Markdown/HTML: 配列の最初のオブジェクトが持つキーの名前が見出し行になり、各オブジェクトの値がそのキーの順番どおりに1行になります。
この3つの規則さえあれば、表がいくつあっても手作業で移せますが、行が多くなるとミスが増えます。貼り付けるだけで同じ規則をそのまま適用し、残り2つのフォーマットを同時に表示する無料ツール「Markdown ↔ HTML ↔ JSON テーブル双方向変換器」を、以下からすぐに試せます。
変換したいマークダウン表のソース、HTMLタグ、JSONデータを入力欄に入れると、他のフォーマットのテーブルデータとしてすぐに確認できます。

よくつまずくポイント
| 状況 | 実際の処理 |
|---|---|
Markdownの2行目に区切り線(-)がない | 区切り線として認識されず、2行目がそのままデータ行の1つとして入ります |
| 行ごとにセルの数が違う | 見出し行よりセルが足りなければ空文字列で埋め、多ければ超過分を捨てます |
HTMLでヘッダー行(<th>)と本文行(<td>)が分かれている | 見出し行は正常に認識されますが、ヘッダーがあった<tr>が最初のデータ行としてもう一度入ることがあるため、結果の1行目が見出しと同じテキストになっていないか確認する必要があります |
| JSON配列のオブジェクトごとにキーの構成が違う | 最初のオブジェクトのキーだけが見出し行として使われ、他のオブジェクトにしかないキーの値は結果に反映されません |
まとめ
3つのフォーマットは、「見出し行 + 値の行」という同じ構造を別の文法で表しているだけです。手作業で移すときもこの対応規則さえ守ればよく、変換ツールはその規則を入力のたびに自動で適用して結果を表示します。ただし、ヘッダーの区切り線の有無、セルの数の不一致、HTMLのヘッダー行の重複など、実際によく引っかかるポイントについては、上の表をもとに結果を一度目で確認したほうが安全です。
変換したいマークダウン表のソース、HTMLタグ、JSONデータを入力欄に入れると、他のフォーマットのテーブルデータとしてすぐに確認できます。
よくある質問
表に結合されたセル(rowspan・colspan)があっても大丈夫ですか?
3つのフォーマットはいずれも「見出し行 + 値の行」だけを扱うため、結合されたセルには対応していません。結合を解除して各セルに値を入れてから入力してください。
変換結果に見出し行と同じ内容がもう一度出てきたときはどうすればよいですか?
HTMLの入力で<th>が入った<tr>がヘッダー用に別にある場合、その行がデータ行としてももう一度入ることがあります(上の表を参照)。変換結果からその行だけを削除すれば問題ありません。
セルの中に改行や|の文字が入っていてもよいですか?
Markdown形式では|そのものがセルの区切り文字なので、セルの中にパイプ文字があると表が正しく分割されません。改行も新しい行として解釈されて表が崩れるため、値の中には入れないほうが安全です。
この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む