HTMLをMarkdownに変換する方法
- HTMLのフラグメントを貼り付けるか、サポートされている
.htmlファイルをアップロードします。 - ソースを変換し、Markdownにおいてどの意味論的要素(セマンティック要素)が意味を持ち続けるかを確認します。
- リンク、画像、ネストされたリスト、表、およびコードフェンスを変換し、確認します。
- Markdownをコピーするか、
.mdファイルをダウンロードします。
変換ツールはどのような情報を保持しますか?
| ソースコンテンツ | 推奨される出力動作 | 変換に関する注意事項 |
|---|---|---|
| 見出し | <h1>~<h6>をMarkdownの見出しに対応付けます | |
| 段落と強調 | 段落、太字、斜体を変換します | |
| リスト | 順序付き、順序なし、およびネストされたリストを変換します | |
| リンク | テキストと解決されたURLを保持します | |
| 画像 | ソースと代替テキスト(alt)を保持します | |
| コード | インラインコードとコードブロックを使用します | |
| 表 | 互換性のある表をGFMに変換します | |
| 引用 | 意味論的な引用ブロックを変換します |
HTML から Markdown への一般的な使用法
Web ドキュメントを移行する
セマンティック HTML を Markdown ベースのドキュメント システムに移動します。
クリーンコピーされたリッチテキスト
バージョニングまたは公開する前に、エディターで生成された HTML をより単純な形式に変換します。
コード例を準備する
ページ全体のスタイルシートを保持せずに、コード ブロックと見出しを保持します。
テキストファーストの AI コンテキストを作成する
レビューが必要な情報構造を保持したまま、スクリプトとスタイルを削除します。
非表示および定型(ボイラープレート)コンテンツ
非表示要素、ナビゲーション、および視覚的に折りたたまれたコンテンツに対する明確な処理ポリシーが必要です。
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を保持すると情報は維持されますが、移植性が低下する可能性があります。
数ギガバイトのファイルをスムーズに処理する
SolConverter は、ワークスペースをフリーズさせることなく、数ギガバイトのファイルを移動し続けるように構築されています。ソース データを管理しやすいチャンクで処理し、画面上のプレビューを軽量に保ち、結果全体を一度にロードせずに完成したアーティファクトをダウンロードできるようにします。
ファイル サイズが大きくなっても、アップロード、変換、プレビューの応答性は維持されます。バックグラウンド処理と進行状況の更新により負荷の高い作業が処理されるため、ブラウザーのワークスペースを使用可能な状態に保ちながら、数 GB のソース ファイルを処理できます。
よくある質問
<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への変換ツールをご利用ください。