HTML Markdown 変換ツール

HTML ファイルと URL

HTML から Markdown は、すでに手元にある HTML から始めます。URL から Markdown は、ネットワークアドレスから始め、公開ページを取得してから変換します。既知のスナップショット、テンプレートの書き出し、自社システムがすでに収集した内容を処理するときは、保存した HTML ファイルを使います。今取得したい公開ページが原本であるときは、URL ツールを使います。HTML 変換ツールはスクリプトを実行して欠けた内容を埋めることはないので、保存したアプリケーションの外枠には、ブラウザで見た記事の内容がほとんど含まれないことがあります。Markdown の出力を調べる前に、送信する元を確認し、必要なテキストが実際にあるかを確かめてください。

出力を確認する

HTML から Markdown は、見出し、段落、リスト、リンク、コード、単純な表を簡潔なテキスト形式で表せます。CSS の位置指定や対話的なコントロールは、通常の Markdown に直接の対応物がありません。見出し要素を意味をもって使うページは、スタイルを当てた汎用コンテナで作ったページより、変換ツールに明確なアウトラインを与えます。書き出した見出しの階層と、代表的な入れ子リストを Markdown ソースで確認します。表では、見出しが下の値を引き続き説明しているかを確かめます。目的は文書内容の読める表現であり、ブラウザのレイアウト、ホバー動作、視覚テーマの再現ではありません。

ナビゲーションとリンク

HTML から Markdown は、記事と一緒にナビゲーション、フッターのテキスト、その他の内容を残すことがあります。変換ツールが記事本文を特定したとか、広告をすべて除いたと考えないでください。検索インデックスに加える前に、書き出しの先頭と末尾に繰り返しのメニューがないか確認します。保存した HTML ファイルは、元サイト上の位置に意味が依存する相対リンクを含むこともあります。それらのリンク先は、Markdown を公開する文脈で確認し、自分のワークフローに意味のある元参照を添えてください。リンクの構文を変換してもリンク先が存在する証拠にはならず、ローカルファイルが元サイトの基準アドレスを自動で与えるわけでもありません。

CMS 移行

CMS 全体を書き出す前に、代表的な投稿で HTML から Markdown を試します。表、コード、画像、リンク、入れ子の見出しを含む投稿を選ぶと、重要な違いを早く見つけられます。Markdown エンジンは拡張の対応が異なることがあるので、移行先のレンダラーで結果を比較します。元の HTML の書き出しを監査用のコピーとして保管し、どの記事のものかを記録します。繰り返しのナビゲーションやメディア資産をどう扱うかは移行プロセスで決めてください。この変換ツールはコンテンツの公開やサイトのファイル移動を代行しません。見直した Markdown の書き出しは、その移行の持ち運べる出発点であり、完了したサイト移転ではありません。

ファイルが保つもの

このツールはすでに手元にあるファイルを変換します。ネットワークから取得はしません。ファイル内にあるナビゲーション、フッター、その他の定型要素は Markdown に現れることがあるので、埋め込む前に確認してください。生きた Web ページを URL で変換するには、URL から Markdown への変換ツールを使ってください。

• HTML の見出しタグ（h1〜h6）は Markdown の見出しに対応します。
• HTML の表は Markdown のパイプ表になります。
• インラインの script と style のブロックは除去され、見える文書内容だけが保たれます。