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

公開ツールMarkdown ↔ HTML ↔ JSON テーブル双方向変換器

目次
  1. Markdownの表をHTML・JSONに変換するときにつまずくポイント
  2. 3つのフォーマットを手作業で移す方法: 規則は1つだけ
  3. よくつまずくポイント
  4. まとめ
  5. よくある質問

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 テーブル双方向変換器」を、以下からすぐに試せます。

Markdown ↔ HTML ↔ JSON テーブル双方向変換器

変換したいマークダウン表のソース、HTMLタグ、JSONデータを入力欄に入れると、他のフォーマットのテーブルデータとしてすぐに確認できます。

よくつまずくポイント

状況実際の処理
Markdownの2行目に区切り線(-)がない区切り線として認識されず、2行目がそのままデータ行の1つとして入ります
行ごとにセルの数が違う見出し行よりセルが足りなければ空文字列で埋め、多ければ超過分を捨てます
HTMLでヘッダー行(<th>)と本文行(<td>)が分かれている見出し行は正常に認識されますが、ヘッダーがあった<tr>が最初のデータ行としてもう一度入ることがあるため、結果の1行目が見出しと同じテキストになっていないか確認する必要があります
JSON配列のオブジェクトごとにキーの構成が違う最初のオブジェクトのキーだけが見出し行として使われ、他のオブジェクトにしかないキーの値は結果に反映されません

まとめ

3つのフォーマットは、「見出し行 + 値の行」という同じ構造を別の文法で表しているだけです。手作業で移すときもこの対応規則さえ守ればよく、変換ツールはその規則を入力のたびに自動で適用して結果を表示します。ただし、ヘッダーの区切り線の有無、セルの数の不一致、HTMLのヘッダー行の重複など、実際によく引っかかるポイントについては、上の表をもとに結果を一度目で確認したほうが安全です。

Markdown ↔ HTML ↔ JSON テーブル双方向変換器

変換したいマークダウン表のソース、HTMLタグ、JSONデータを入力欄に入れると、他のフォーマットのテーブルデータとしてすぐに確認できます。

よくある質問

表に結合されたセル(rowspan・colspan)があっても大丈夫ですか?

3つのフォーマットはいずれも「見出し行 + 値の行」だけを扱うため、結合されたセルには対応していません。結合を解除して各セルに値を入れてから入力してください。

変換結果に見出し行と同じ内容がもう一度出てきたときはどうすればよいですか?

HTMLの入力で<th>が入った<tr>がヘッダー用に別にある場合、その行がデータ行としてももう一度入ることがあります(上の表を参照)。変換結果からその行だけを削除すれば問題ありません。

セルの中に改行や|の文字が入っていてもよいですか?

Markdown形式では|そのものがセルの区切り文字なので、セルの中にパイプ文字があると表が正しく分割されません。改行も新しい行として解釈されて表が崩れるため、値の中には入れないほうが安全です。

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

関連記事

  1. テキストファイルを結合する方法と文字化け防止分かれたテキスト(TXT)ファイルをまとめて結合する手順と、区切り文字・ファイル名ヘッダーのオプション、結合後に起こるEUC-KRの文字化けを避ける確認ポイントを解説します。
  2. モックJSONのダミーデータ生成とAPIテスト設計UUID・連番ID・仮のメールや乱数で作るダミーJSONの生成ロジックと、モックのネットワーク遅延を再現してAPIテストを進める際のチェックポイントを解説します。
  3. モールス信号 音の長さの公式とWeb Audio APIモールス信号の音の長さの公式(短点1・長点3)と、Web Audio APIのオシレーターでビープ音を合成する方法を解説します。周波数とWPMの考え方も整理します。
  4. モールス信号の変換方法とアルファベット対応表点(.)と線(-)の組み合わせで文字を表すモールス信号について、アルファベット・数字の対応表と、文字と単語を区切る変換ルールを解説します。
  5. 英語名のイニシャル変換|抽出ルールと大文字表記の基本姓と名の順序、大文字への統一、区切り記号の付け方など、英語のフルネームからイニシャルを作る手順と、航空券や署名まわりで迷いやすい点を整理して解説します。
  6. コンピュータの基数変換の公式と2進数・8進数・10進数・16進数の計算方法2進数・8進数・10進数・16進数が互いに変換される仕組みと、JavaScriptのtoString/parseIntの使い方、浮動小数点の誤差が生じる理由を解説します。

関連ツール