HTMLをMarkdownに変換する方法
- HTMLのフラグメントを貼り付けるか、サポートされている
.htmlファイルをアップロードします。 - ソースを変換し、Markdownにおいてどの意味論的要素(セマンティック要素)が意味を持ち続けるかを確認します。
- リンク、画像、ネストされたリスト、表、およびコードフェンスを変換し、確認します。
- Markdownをコピーするか、
.mdファイルをダウンロードします。
変換ツールはどのような情報を保持しますか?
| ソースコンテンツ | 推奨される出力動作 | 変換に関する注意事項 |
|---|---|---|
| 見出し | <h1>~<h6>をMarkdownの見出しに対応付けます | |
| 段落と強調 | 段落、太字、斜体を変換します | |
| リスト | 順序付き、順序なし、およびネストされたリストを変換します | |
| リンク | テキストと解決されたURLを保持します | |
| 画像 | ソースと代替テキスト(alt)を保持します | |
| コード | インラインコードとコードブロックを使用します | |
| 表 | 互換性のある表をGFMに変換します | |
| 引用 | 意味論的な引用ブロックを変換します |
変換中に変化する可能性のあるものは何ですか?
スクリプト、スタイル、およびフォーム
実行可能要素やインタラクティブ要素には通常のMarkdownに対応するものがないため、省略されるかテキストに簡略化される場合があります。
複雑な表
行の結合(rowspan)、列の結合(colspan)、入れ子の表、およびセル内のリッチコンテンツは、生のHTMLを使用するか、フラット化(平坦化)が必要な場合があります。
相対URL
貼り付けられたフラグメントにはページのベースURLが含まれていない場合があるため、相対リンクや画像パスが常に解決できるとは限りません。
レイアウトコンテナ
div、グリッド、およびフレックスボックスのレイアウトは、意味論的な読取順序を意味しません。
非表示および定型(ボイラープレート)コンテンツ
非表示要素、ナビゲーション、および視覚的に折りたたまれたコンテンツに対する明確な処理ポリシーが必要です。
HTMLからMarkdownへの一般的な用途
Webドキュメントの移行
意味論的なHTMLをMarkdownベースのドキュメントシステムに移行します。
コピーされたリッチテキストのクリーンアップ
エディターで生成されたHTMLを、バージョン管理や公開の前にシンプルな形式に変換します。
コード例の準備
ページ全体のスタイルシートを持ち込むことなく、コードブロックと見出しを保持します。
テキスト優先のAIコンテキストの作成
レビューする必要のある情報構造を維持しながら、スクリプトとスタイルを削除します。
HTMLからMarkdownへの変換例
<h2>Setup</h2>
<p>Read the <a href="/guide">guide</a>.</p>
<ul><li>Install</li><li>Test</li></ul>
## Setup
Read the [guide](/guide).
- Install
- Test
クリーンなMarkdownを出力するためのヒント
- 意味論的なHTMLを使用する 一般的なレイアウトコンテナよりも、見出し、リスト、表の方が信頼性高く変換されます。
- 必要に応じてベースURLを提供する 元のページの外で結果を機能させる必要がある場合、相対リンクにはコンテキストが必要です。
- 出力方言(仕様)を選択する GFMは、標準のCommonMarkが定義していない表やタスクリストをサポートしています。
- コードフェンスを確認する 検出されたプログラミング言語と埋め込まれたバックティック(逆引用符)を確認します。
- 生のHTMLフォールバックを決定する サポートされていないHTMLを保持すると情報は維持されますが、移植性が低下する可能性があります。
よくある質問
<script> や <style> 要素は削除されますか?
スクリプトとスタイルは有用なMarkdownコンテンツではないため、変換結果でそれらに依存すべきではありません。 出力を再利用する前に、貼り付けられたHTMLを確認してください。
HTMLの表はMarkdownの表に変換されますか?
互換性のある長方形の表はGFMの表に変換できます。 rowspan、colspan、ネストされたブロック、または複数のヘッダー行を持つ表には、ドキュメント化されたフォールバックが必要です。
コードブロックとインラインコードは保持されますか?
それらは <pre> や <code> からマッピングされます。
リンクや画像はどうなりますか?
有効なリンクテキストとリンク先は保持される場合があります。 アップロードされたフラグメントには保証されたベースURLがないため、相対リンクと画像パスはコンテキスト依存のままになります。
サポートされていないHTMLタグは削除されますか、それとも保持されますか?
表示専用のラッパーは簡略化され、読み取り可能なテキストが保持される場合があります。 カスタム要素に意味がある場合は、出力をソースと比較してください。
変換ツールはCommonMarkとGFMのどちらを出力しますか?
想定される出力はGitHub-Flavored Markdown(GFM)です。 表、打ち消し線、およびタスクリストはGFMの拡張機能に依存しています。
HTMLドキュメント全体を貼り付けることはできますか?
はい。 フラグメントを貼り付けるか、.html または .htm ファイルをアップロードして、生成されたMarkdownを確認できます。
このページで公開されているWebサイトのURLを変換できますか?
いいえ。 このページは貼り付けられたHTMLまたはアップロードされたHTMLファイルのみを受け付けます。公開されているWebサイトのURLを取得することはしません。
MarkdownをPDFに戻す
すでにMarkdownファイルをお持ちですか? 共有可能なPDFを作成するには、MarkdownからPDFへの変換ツールをご利用ください。