.md → .html 変換ツール
APP$ md2htmlPUB UPD 出典 — 標準・公式資料 ✓ ブラウザー内で完結 — 入力内容をサーバーに送信せず、すべてのレンダリングをこのブラウザー内で行いますMarkdown(.md)を入力すると、すぐ下にプレビューが表示され、そのまま単一の .html ファイルに保存できます。主な記法は検索できるので、暗記しなくても、文書を書きながらその場で確認できます。
| 種類 | 記法 | 結果 | 区分 |
|---|
ツールの使い方
使う場面
Markdown で案内文や作業メモを書いた後、読者に見せる見出し・リスト・強調・リンクを確認するときに使います。INPUT の Markdown 原稿に入力すると、下の RESULT に表示されます。見出しの階層と段落の区切りを確かめながら原稿を直します。ブラウザーで読める文書が必要な場合は、HTML ファイルとして保存します。
既存の原稿は、端末内の md ファイルを開くボタンから読み込みます。内容を追記をオンにすると原稿の末尾に追加し、オフにすると読み込んだ内容で入力欄を置き換えます。追記時には、段落がつながらないように、ツールが必要な空行を自動で入れます。ファイルと内容はこのブラウザーで読み取り、変換のためにサーバーへアップロードしません。
結果の読み取り方
RESULT は、入力した記法を解釈したプレビューです。見出しの区切り、リストの階層、強調とリンクを先に確認します。SYNTAX の検索は、記法・名称・説明に合う行をガイドの表から絞り込みます。記法ガイドを非表示にしたり検索語を変えたりしても、原稿自体は変わりません。
構造の要約には、見出し・段落・リスト項目・表・コードブロック・リンクの数と入力文字数が表示されます。想定した表がない場合やリスト項目が多い場合は、その箇所の記法と空行を調べてください。数値は生成した構造の集計であり、内容の正確さを判定するものではありません。RESULT の上にある案内で、GFM の設定と対応範囲も確認します。
実測した例
実測では、점검 を第1階層の見出し、굵게 を太字の強調、첫째 と 둘째 をリスト項目として入力しました。홈 というリンクと、항목・값 の二列に A・1 を入れた表も入力しました。GFM をオンにすると、この構造とデータ行が一つある表が表示されました。
GFM だけをオフにすると、見出し・強調・二つのリスト項目・リンクはそのままでした。表の構造がなくなり、縦線の文字を含む通常テキストが表示されました。同じ原稿でも、設定によって表の解釈が変わりました。
主な質問と回答
Enter を押しても同じ行に表示されるのはなぜですか。
通常の段落では、Enter を一度押すだけでは強制改行になりません。新しい段落は空行で区切り、同じ段落内で改行する場合は前の行の末尾に半角スペースを二つ入れます。CommonMark が区別する段落と強制改行を、文の目的に合わせて選んでください。
原稿に含まれる HTML も実行しますか。
このツールは、生の HTML を文字として表示します。タグを入力してページの構造やスクリプトを実行する機能はありません。そのため、HTML を許可する別の Markdown エディターと同じ表示になるとは限りません。
GFM をオンにすると、すべての拡張記法を使えますか。
GFM の設定は、表・チェックボックス・取り消し線など、このツールが実装する拡張に適用します。脚注は CommonMark と GFM の規格外の記法で、このプレビューでは文字のまま残ります。記法ガイドの共通・GFM・規格外の区分と、貼り付け先の対応状況を併せて確認してください。
画像が表示されないのはなぜですか。
このツールは Markdown の画像を外部から取得せず、代替テキストと案内を表示します。新しいウィンドウと保存ファイルにも同じ変換処理を使うため、画像ファイルを含む一式の文書にはなりません。画像の配置まで必要な文書は、別途確認してください。
さらに詳しく
動作の仕組み
変換処理は入力をまず文字として扱い、見出し・段落・リスト・引用・コードなどのまとまりに分けます。その中のコード・リンク・強調を解釈し、HTML を作ります。GFM をオンにすると、表やタスクリストにも対応する規則を適用します。原稿の改行と字下げが構造を決めるため、見た目が似た入力でも結果が変わる場合があります。
新しいウィンドウで表示と html ファイルとして保存は、同じ原稿と GFM の設定から独立した HTML 文書を作ります。文書には本文と基本的な表示用スタイルを含めます。プレビューでは第1階層の見出しをページ自体の見出しと区別して表示しますが、出力文書では元の階層を使います。保存前に、現在の原稿と結果を併せて確認してください。
参照した標準と資料
参照標準にある CommonMark Spec 0.31.2 は基本記法を、GitHub Flavored Markdown Spec は表・タスクリスト・取り消し線などの拡張を説明します。HTML Living Standard は出力文書の要素の根拠です。記法の根拠と、このツールの実装範囲は分けて考えます。生の HTML を文字として表示し、画像を取得しない処理は、このツール独自の規則です。
制約事項
ファイル読み込み後の合計は、UTF-16 基準で 300,000 文字までです。追記時も合計を確認し、上限を超える場合は途中で切らずに読み込みを止めます。直接入力と貼り付けには、この上限を適用しません。バイト数とは異なり、一部の絵文字のように、画面上の一文字を複数の単位で数える場合があります。
すべての Markdown 実装と同じ結果を保証したり、文書の事実を検証したりするツールではありません。長い原稿は入力が止まってから更新される場合があり、処理時間は端末と文書構造によって変わります。別のサービスへ移すときは、その場所での記法の対応と表示を確認してください。編集を続ける Markdown の原本も別に保管します。
出典: CommonMark Spec 0.31.2 (Markdown の記法) · GitHub Flavored Markdown Spec (表・タスクリスト・取り消し線) · HTML Living Standard (HTML 出力)