機能
Markdown → HTML 変換ツールは、Markdown のテキストを HTML マークアップに変換します。CMS、メールテンプレート、静的ページなど、HTML は受け付けても Markdown は使えない場所に貼り付けられます。README を Web サイトで公開したり、メモをブログエディタに移したり、Markdown の断片がどのタグになるかを確認したりするのに便利です。
出力は一般的な Markdown レンダラーと同じ HTML です。<h1> から <h6> の見出し、<p> の段落、<ul> と <ol> のリスト、シンタックスハイライト用の language- クラス付き <pre><code> ブロック、GitHub 形式の表の <table> が生成されます。
使い方
- Markdown を入力または貼り付けるか、
.mdファイルをアップロードするか、サンプル をクリックします。 - 必要なオプションを選びます。GitHub Flavored Markdown、改行を
<br>に、アンカーリンク用の見出し ID、信頼できない入力向けのサニタイズ、断片ではなく完全な HTML ドキュメントの出力です。 - HTML をコピーするか、
.htmlファイルとしてダウンロードします。
結果は入力に合わせて更新されます。既存のページに貼り付けるときは完全なドキュメントをオフに、単体のファイルが欲しいときはオンにしてください。
例
この Markdown は:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
次の HTML になります:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
ヒント
- Markdown 内の生の HTML は、多くのレンダラーと同じく既定ではそのまま残ります。他人が書いた Markdown なら必ずサニタイズをオンにしましょう。
- 見出し ID をオンにすると、
page.html#installのようなアドレスで節にリンクでき、見出しから目次も作れます。 - コードブロックの言語はクラスとして残るので、Prism や highlight.js などのハイライターが追加設定なしで認識します。
- 表示結果を並べて確認するには Markdown プレビューを、逆方向の変換には HTML → Markdown 変換を使ってください。
よくある質問
› どの Markdown 記法に対応していますか?
見出し、強調、リンク、画像、リスト、引用、コード、水平線など CommonMark のすべてに対応します。GitHub Flavored Markdown をオンにすると、列の揃えを指定できる表、タスクリスト、取り消し線、URL の自動リンクも使えます。
› サニタイズオプションは何をしますか?
Markdown 内の生の HTML をタグにせずテキストとして表示されるようエスケープし、javascript や vbscript など危険なスキームの URL を持つリンクと画像を取り除きます。コメントや掲示板の投稿など、信頼できないユーザーが書いた Markdown ではオンにしてください。
› 見出し ID はどのように作られますか?
GitHub と同じ方法です。見出しのテキストを小文字にし、記号を除き、空白をハイフンにするので、Getting Started の id は getting-started になります。同じ見出しが続くと -1、-2 などが付き、アンカーは常に一意になります。
› 完全な HTML ドキュメントのオプションは何に使いますか?
結果を doctype、UTF-8 の charset、viewport タグ、最初のレベル 1 見出しから取った title、読みやすい小さなスタイルシートを備えた完全なページで包みます。.html ファイルとして保存すれば、どのブラウザでもきれいに開けます。
› Markdown はどこかに送信されますか?
いいえ。変換はブラウザ内で marked ライブラリによって行われ、サーバーには何もアップロードされません。