JSON → Markdown 変換ツール

JSONをMarkdownに変換する方法

1. 上の入力欄にJSONを貼り付けるか.jsonファイルをドロップし、サンプルを読み込むを押すと有効な文書から始められます。入力しながらMarkdownが再生成され、問題があれば入力欄の下に表示されます。
2. 各ブロックが順に書き出されます。headingは#〜######、paragraphは本文、listは箇条書き（orderedがtrueなら番号付き）、tableはGFMテーブル、codeはフェンス付きコードブロックになります。
3. Markdownをコピーするか.mdとしてダウンロード、またはエディタで開いて表示を確認しながら編集を続けられます。

受け付ける形式

• 文書オブジェクト（{"blocks": [...]}）またはブロックの配列です。配列はJSON.parseしただけのデータをそのまま渡せます。オブジェクトでないブロックは飛ばさず、位置を添えて報告します。
• textは書かれているとおりMarkdownとして出力されます。文字列がMarkdownではなくプレーンテキストの場合はMarkdown記法をエスケープをオンにしてください。C# *ガイド*のような名前が書式として解釈されなくなります。
• 入れ子のリストは項目のlistフィールドに入り、タスク項目はcheckedをtrueまたはfalseにします。未知のブロック型は推測せず報告するので、打ち間違いが節を黙って飲み込むことはありません。

よくある質問

どのJSON形式を想定していますか？

Markdown → JSON変換ツールが出力する形式です：{"blocks":[{"type":"heading","depth":2,"text":"インストール"}]}。同じブロックの配列だけでも動作し、typeがなくtextがあるブロックは段落として扱います。

未知の型というエラーが出るのはなぜですか？

ブロックのtypeがないか綴りが違うためです。メッセージには配列内の位置が出ます。対応する型とフィールドはツール下のリファレンスに一覧があります。

JSONはアップロードされますか？

いいえ。ファイルのドロップも含め、解析と変換はこのブラウザタブ内で行われます。どこにも送信されず、サーバー側の処理もありません。

表・コード・入れ子のリストはどう扱われますか？

表はヘッダーと列の揃えを保ち、セル内の縦棒はエスケープします。フェンスを含むコードには、途中で終わらないよう長いフェンスを使います。入れ子のリストは親項目の下にインデントされます。