Webページのレイアウトではなく文書構造を抽出
保存またはコピー済みのHTMLを使って、ドキュメントやリポジトリ向けの読みやすい原稿を作成できます。見出し、リンク、リスト、一般的な表を保ちながら、スクリプトやページのスタイルは削除します。保存前に生成されたMarkdownを確認できます。
このツールはHTMLからMarkdownへの変換用で、Webページのスクレイピングは行いません。ソースを貼り付けるかHTMLファイルを開いてください。ページURL、スクリーンショット、PDFは異なる入力形式のため、取得・解析できません。
HTML変換後に保持される内容
基本的な文書要素
見出し、強調、リンク、リスト、引用、基本的なコードブロックを、対応するMarkdownの記法に変換します。
表を編集できるソースに変換
シンプルなHTML表はGFM形式のパイプ表に変換されます。複数行・列にまたがっていたセルや見出しを確認してください。
テキストと表示結果を確認
Markdownソースとプレビューを切り替えられます。納品物はソースです。プレビューを使うと階層の抜けや予期しない改行を確認できます。
端末内で変換
HTML/テキストファイルを開くかソースを貼り付けて、Markdownをコピーまたはダウンロードします。変換時のアップロードは不要です。
実際に必要な文書から始めましょう
HTML記事の抜粋
記事の内容をリポジトリやドキュメントの原稿に移します。
<h2>確認リスト</h2> <p>公開前に<strong>ソース</strong>を確認してください。</p> <ul><li>主張を検証</li><li>リンクを確認</li></ul>
- 見出しレベルが維持される。
- 強調が読みやすい。
- リスト項目が別々に保たれる。
シンプルなHTML表
通常のセルを編集可能なMarkdown表に変換します。
<table> <thead><tr><th>形式</th><th>用途</th></tr></thead> <tbody><tr><td>HTML</td><td>Webコンテンツ</td></tr><tr><td>Markdown</td><td>編集可能なソース</td></tr></tbody> </table>
- 見出し行として認識される。
- 結合セルを想定しない。
- セルの文字がすべて残る。
基本的な使い方
実際のHTMLソースを使う
マークアップを貼り付けるか.html/.htmファイルを開きます。URLを貼り付けてもWebサイトは取得されません。また、ページ上でコピーした内容にソースが含まれるとは限りません。
簡略化された箇所を確認
見出しレベル、入れ子のリスト、表の見出しを確認します。レイアウト用コンテナーとCSSのスタイルはMarkdownの結果には含まれません。
原稿を仕上げる
MarkdownをコピーするかMDをダウンロードしてください。表の再構成、コードブロックの調整、説明の追加が必要な場合はMarkdownエディターで続けられます。
共有する前に結果を確認
| 内容 | 操作 | 確認できること |
|---|---|---|
| 結合セル | rowspanやcolspanに含まれる内容を手動で確認します。 | 基本的なMarkdown表記では、HTMLのすべての表レイアウトを表現できません。 |
| 画像 | 有効な完全URLを保つか、後でローカル画像を埋め込みます。 | 相対パスは元のWebページの情報を失うため、修正が必要です。 |
| コードと改行 | 生成されたコードフェンスと段落の区切りを確認します。 | 空白に依存するレイアウトは手作業での修正が必要な場合があります。 |
| 埋め込みスクリプトとフォーム | 結果に意図した文書テキストだけが含まれていることを確認します。 | Webページのインタラクティブな動作は削除されます。 |
この手順について
HTMLをMarkdownに変換するには？
HTMLソースを貼り付けるか、保存済みの.htmlファイルを開きます。プレビューを確認し、Markdownに切り替えて生成された記法を確認してから、コピーまたは.mdファイルをダウンロードして編集を続けてください。
HTMLの表をMarkdownに変換できますか？
通常の表構造であれば可能です。GFMのパイプ表では結合セル、入れ子のレイアウト、すべてのセル単位のスタイルを完全には表現できないため、そのような箇所は手動で確認してください。
WebサイトのURLを入力できますか？
このページはWebサイトを取得しません。該当するHTMLソースをコピーするか、HTMLファイルを保存して開いてください。動的なページの内容を取得するには、別の手順が必要な場合があります。
フォント、色、レイアウトは維持されますか？
Markdownは任意のページスタイルではなく、文書の構造を表します。スクリプト、フォーム、カスタムCSS、インタラクティブな要素は削除されます。
画像が表示されなくなったのはなぜですか？
相対パスが使われているか、元のサイトに依存している可能性があります。有効な完全URLに置き換えるか、Markdownエディターからローカル画像を追加してください。
HTMLはアップロードされますか？
HTMLからMarkdownへの変換、プレビュー、MDのダウンロードはブラウザー内で行われます。任意の外部画像読み込みを有効にした場合は、画像ホストへアクセスします。
文書の取り扱いについて
- HTMLソースを無害化してから端末内で変換します。
- 出力されるのは文書の内容であり、Webページを実行できる形で複製するものではありません。
- 貼り付け先のエディターによってMarkdown拡張の解釈が異なる場合があります。まず小さなサンプルを確認してください。
形式に関する参考資料TurndownプロジェクトGitHub Flavored Markdownの表
再現できる問題を報告ブラウザー、選択した設定、機密情報を含まない小さなサンプルをお知らせください。個人情報を含むファイルはメールで送信しないでください。
