HTML to Markdown 変換 — Web ページやメールの HTML を README 用 Markdown に
Web ページ、メール、書き出した文書の HTML を貼り付けると Markdown になります。GFM の表、チェックボックス付きタスクリスト、言語付きコードブロック、ネストしたリストや引用も復元。インライン style と class は破棄、画像 URL はそのまま、script/style は除去、崩れた HTML も自動修正し、URL 取得もアップロードもしません。
この HTML→Markdown 変換が残すもの/捨てるもの
GFM の表・タスクリスト・コード言語を復元
<table> はパイプ表に、<li> 内のチェックボックスは - [x] / - [ ] に、<code class="language-js"> は ```js ブロックとして言語を保持します。リスト項目の外にあるチェックボックスはエスケープされたテキスト \[x] になるだけです。
スタイルと class は破棄、画像 URL は保持
style、class、id などの表現属性は引き継がず、構造と意味だけを残します。<img> は  となり、元のリモート URL をそのまま使います。ダウンロードも再ホストもしません。
script・style・埋め込みは除去
<script> と <style> は中身ごと消え、<iframe> は空リンク []() に、<video> は破棄されます。HTML コメントは <!-- --> として Markdown に残ります。
ネストしたリストと引用を保持
ネストした <ul>/<ol> は 2 スペースのインデントで階層を保ち、ネストした <blockquote> は > > になります。<li> 内の <p> を外す処理により余分な空行も防ぎます。
崩れた HTML も変換でき、すべてローカル
parse5 が閉じていないタグを自動修正するので、断片でも <html> 全体でもそのまま貼れます(<title> などの head 要素は無視)。URL 取得・アップロード・サーバー処理はなく、結果は読み取り専用のテキストエリアに出るので手動でコピーします。
HTML→Markdown 変換の FAQ
どの変換ライブラリを使っていますか?
unified 11 のパイプラインです。rehype-parse 9(parse5)で HTML を解析し、小さな独自 visitor が <li> 内の <p> を外し、rehype-remark 10(hast-util-to-mdast)で Markdown のツリーに変換し、remark-stringify 11 と remark-gfm 4 でシリアライズします。
表・タスクリスト・コード言語は復元されますか?
表はヘッダー区切り付きのパイプ表に、<li> 内のチェックボックスは - [x] / - [ ] に、class="language-js" は ```js ブロックに復元されます。リスト項目の外のチェックボックスはエスケープされたテキスト \[x] になるだけです。
インライン style・class・画像はどうなりますか?
style や class などの表現属性は破棄され、構造と意味だけが残ります。画像は元の URL を  として保持し、ダウンロードや再ホストはしません。認証が必要な画像リンクは後で表示できなくなります。
script・style・iframe は除去されますか?
<script> と <style> は中身ごと除去されます。<iframe> は空リンク []() になり、<video> は消えます。HTML コメントは除去されず <!-- --> として Markdown に残るため、README で不要なら手で消してください。
ネストしたリストと引用は対応していますか?
対応しています。ネストしたリストは 2 スペースのインデントで階層を保ち、ネストした引用は > > になります。<li> 内の <p> は独自プラグインで外され、余分な空行が出ません。
先に HTML を整える必要がありますか?
不要です。parse5 が閉じていないタグや断片を自動修正し、断片でも <html> 全体でも受け付けます(<title> など head 要素は無視)。出力は正規化される場合があるので、コミット前に一度読んで確認してください。
URL から取得できますか?アップロードはありますか?
URL 取得もアップロードもありません。すべてブラウザ内で動作し、HTML を貼り付ける(貼り付けショートカットではクリップボードの text/html を読み取る)と、読み取り専用テキストエリアに Markdown が出ます。プレーンテキストを貼ると text/plain にフォールバックします。

