このツールについて
Markdown は HTML の一部に直接対応する軽量なマークアップ構文です。見出し、強調、リンク、リスト、コードブロック、引用、テーブルなどが対象です。このコンバーターは GitHub-flavored Markdown (GFM) を有効にして Markdown を HTML にレンダリングするため、パイプテーブルや取り消し線が機能します。そしてその結果はページに反映される前に DOMPurify に通され、スクリプトや安全でない属性が取り除かれます。逆方向では、解析された HTML の DOM をたどってクリーンな Markdown を出力し、GFM のテーブルをパイプ構文に戻し、フェンス付きコードブロックの言語指定を保持します。
README や changelog の下書きを CMS に貼り付けられる HTML に変換したり、HTML ビューで Markdown が生成する HTML を正確に確認したり、ドキュメントページやリッチテキストエディターから貼り付けた HTML の断片から Markdown を逆生成したりするのに使えます。プレビュー / HTML の切り替えにより、レンダリングを目で確認しながらソースを一か所で取得でき、入力するたびにすべてがライブで更新されます。
HTML 出力はレンダリング前に DOMPurify でサニタイズされるため、Markdown 内のスクリプトやイベントハンドラー属性は取り除かれます。プレビューには生の変換結果ではなく、安全な HTML が反映されます。
よくある質問
このコンバーターは GitHub-flavored Markdown (GFM) に対応していますか？
はい。GFM が有効になっているため、パイプテーブル、言語ヒント付きのフェンス付きコードブロック、~~取り消し線~~ がすべて変換されます。HTML から Markdown への方向でも GFM のパイプテーブルが出力されます。
生成された HTML はそのまま安全に使えますか？
HTML は DOMPurify でサニタイズされ、スクリプト、イベントハンドラー、その他の安全でないマークアップが取り除かれます。レンダリングは安全ですが、自分が作成していない HTML を公開する前には常に慎重に扱ってください。
私の Markdown や HTML はサーバーに送信されますか？
いいえ。どちらの方向も JavaScript を使って完全にブラウザー内で実行されます。marked パーサー、DOMPurify、クライアントサイドの DOM ウォーカーを利用します。何もアップロードも保存もされません。