MarkdownをHTMLに変換する方法完全ガイド|VS Code・オンラインツール・Pandoc・Python/JS実装まで徹底解説

Markdown(マークダウン)で書いたドキュメントやブログ記事、技術メモをWebサイトに公開したり、メール・CMS・社内ポータルへ貼り付けたりするために、「Markdownを綺麗なHTMLに変換したい」という場面は日常的によくあります。

しかし、いざHTMLへ変換しようとすると、「ブラウザ上で今すぐコピペしてHTMLコードだけ欲しい」「VS Codeで書いている記事をそのまま1つのHTMLファイルとして書き出したい」「CSSを当てた見栄えの良いHTMLをコマンドやプログラムで自動生成したい」など、目的によって向いているツールや手順が大きく異なります。

さらに、変換ツールやライブラリの設定を誤ると、「表(テーブル)やコードブロックがHTMLタグにならず生の記号のまま出力される」「改行が消えて段落がつながる」「ユーザー入力をそのまま変換してXSS(クロスサイトスクリプティング)の脆弱性につながる」といったトラブルも起こりがちです。

本記事でわかること

  • 【結論】用途別のHTML変換手段(オンライン・VS Code・Pandoc・Python/JSの早見表)
  • インストール不要のオンラインツール(Dillinger・StackEdit)での変換手順と機密情報の注意点
  • VS Code拡張機能(Markdown All in One / Markdown PDF)を使ったローカルでの1クリックHTML出力
  • Pandoc CLIコマンドでのスタンドアロンHTML出力・外部CSS適用・単一ファイル埋め込み
  • Python / JavaScript(Node.js)実装の基本コードと必須のXSSサニタイズ対策
  • 変換時のよくある崩れ対策とHTMLからMarkdownへの逆変換方法

【結論】MarkdownをHTMLに変換する用途別早見表

MarkdownをHTMLに変換する方法は大きく分けて4パターンあります。まずはご自身の環境や目的に合う手段を以下の早見表から選んでください。

目的・シーン おすすめの方法 特徴・メリット 注意点
今すぐブラウザ上で即変換したい オンラインツール
(Dillinger / StackEdit)
インストール不要。コピペだけで即HTML出力・ダウンロード可能 社外秘・個人情報を含む文章の入力は避ける
ローカル環境で手軽に書き出したい VS Code拡張機能
(Markdown All in One 等)
オフライン動作で安全。普段のエディタから数クリックでHTML保存 高度なテンプレート制御には不向き
CSS付きHTML・一括自動変換をしたい Pandoc(CLIコマンド) <head>付きのHTMLやCSS埋め込み、バッチ処理に最適 Pandocのインストールとコマンド操作が必要
Webアプリや自社システムに組み込みたい Python / JavaScript
(marked / markdown-it 等)
動的レンダリングやCMS連携、独自ルールの拡張が自在 外部入力を扱う場合はXSSサニタイズが必須

「とりあえず1回だけHTMLコードを取り出したい」ならオンラインツール、普段からVS Codeを使っているなら拡張機能、ドキュメント生成パイプラインや大量ファイルの変換ならPandocやスクリプト実装を選ぶのが最短ルートです。

オンラインツールでMarkdownをHTMLに変換する方法(インストール不要)

ソフトウェアのインストールや環境構築を一切行わず、WebブラウザだけでMarkdownをHTMLへ変換したい場合は、オンラインのMarkdownエディタ兼コンバーターが便利です。

代表的な無料オンラインツール2選(Dillinger・StackEdit)

  • Dillinger:左側のエディタにMarkdownを貼り付けると、右側にリアルタイムでHTMLプレビューが表示されます。画面右上メニューの「Export as」から「HTML」またはCSS装飾込みの「Styled HTML」を選択するだけで、即座に.htmlファイルをダウンロードできます。
  • StackEdit:高機能なブラウザベースのエディタです。右上のメニューアイコンから「Import/Export」→「Export to disk」→「Export as HTML」を選ぶとHTMLファイルとして書き出せます。Handlebarsテンプレートを使った出力形式のカスタマイズにも対応しています。

どちらのツールも基本記法(見出し・リスト・表・コードブロックなど)に幅広く対応しているため、書き方に迷ったときはMarkdown記法一覧・チートシートもあわせて確認しながら整形するとスムーズです。

オンラインツール利用時のセキュリティ上の注意点

機密情報・社外秘データの入力は避ける

オンラインツールの中には、変換処理や一時保存のためにサーバー側へテキストを送信する仕組みのものもあります。社外秘の仕様書、顧客情報、APIキーやパスワードを含む文書をブラウザ上の外部サービスに貼り付けるのは情報漏洩リスクがあるため、業務データには次に紹介するVS Code拡張機能やPandocなどのローカル変換手段を使用してください。

VS CodeでMarkdownをHTMLに変換する手順

普段からVisual Studio Code(VS Code)でMarkdownを執筆しているなら、外部ツールへコピペする必要はありません。拡張機能を入れるだけで、ローカル環境のまま安全かつ瞬時にHTMLファイルへエクスポートできます。

まだVS CodeでのMarkdownプレビュー表示や基本操作に慣れていない場合は、VS Code マークダウンプレビューの使い方完全ガイドもあわせてご参照ください。

方法①:Markdown All in One(コマンド1つでHTML出力・一括変換)

VS Codeの定番拡張機能である「Markdown All in One」(拡張機能ID:yzhang.markdown-all-in-one)は、入力補完や目次自動生成だけでなく、HTMLへのエクスポート機能も標準搭載しています。

  1. VS Codeの拡張機能タブから「Markdown All in One」をインストールする
  2. HTMLに変換したい.mdファイルを開く
  3. コマンドパレット(Windows:Ctrl + Shift + P / Mac:Cmd + Shift + P)を開く
  4. Markdown: Print current document to HTML と入力して実行する

実行すると、元のMarkdownファイルと同じフォルダ内に同名の.htmlファイルが生成されます。さらに、フォルダ内の複数ファイルをまとめて変換したい場合は、コマンドパレットからMarkdown: Print documents to HTML (select a source folder)を実行することで一括変換も可能です。

方法②:Markdown PDF(CSS適用済みのHTMLを手軽に書き出す)

「Markdown PDF」(拡張機能ID:yzane.markdown-pdf)はPDF変換で有名な拡張機能ですが、実はHTML形式でのエクスポートにも対応しています。

  1. VS Codeに「Markdown PDF」をインストールする
  2. 対象の.mdファイルを開き、エディタ上で右クリック(またはコマンドパレットを開く)
  3. Markdown PDF: Export (html) を選択して実行する

Markdown PDFのメリットは、設定(markdown-pdf.styles)で指定したカスタムCSSやコードブロックのシンタックスハイライトが反映された状態のHTMLをそのまま書き出せる点です。同じ手順でPDFとして保存したい場合は、MarkdownをPDFに変換する方法完全ガイドで詳しく解説しています。

Pandoc・CLIコマンドでHTML変換する方法

大量のMarkdownファイルをバッチ処理で変換したい場合や、CI/CDパイプラインでドキュメントを自動ビルドしたい場合は、ドキュメント変換の万能ツール「Pandoc(パンドック)」をコマンドライン(CLI)から使う方法が最も確実です。

基本コマンド(HTML断片 vs スタンドアロンHTML)

Pandocの変換コマンドでは、-s(--standalone)オプションの有無が重要なポイントになります。

# 1. HTML断片のみ出力(WordPressや既存HTMLへの埋め込み用)
pandoc input.md -f gfm -t html -o fragment.html

# 2. 単独で開けるHTMLファイルとして出力(<!DOCTYPE html>・<head>・<body>付き)
pandoc input.md -f gfm -s -o output.html

なお、GitHub Flavored Markdown(GFM)の表や取り消し線、タスクリストを正確に変換したい場合は、入力フォーマットとして-f gfmを指定するのが推奨です(古いmarkdown_githubは非推奨となっています)。

外部CSSの適用と単一ファイル埋め込み(–css / –embed-resources)

ブラウザで開いたときに読みやすいデザインを整えたい場合は、-c(--css)オプションでCSSファイルを指定します。さらに、HTMLファイル1つだけをメール添付や配布用として共有したい場合は、--embed-resources(単一ファイル埋め込み)を組み合わせます。

# 外部CSSリンク付きのスタンドアロンHTMLを生成
pandoc input.md -f gfm -s -c style.css --metadata title="ドキュメントタイトル" -o output.html

# CSSや画像もHTML内に埋め込んだ単一ファイルとして生成(Pandoc 3.x以降)
pandoc input.md -f gfm -s --embed-resources -c style.css -o portable.html

Pandocを使った別の形式への変換(社内提出向けのWordファイル出力など)も併用したい場合は、MarkdownをWord(docx)に変換する方法完全ガイドでテンプレート適用の応用手順を紹介しています。

Python・JavaScript(Node.js)でMarkdownをHTMLに変換する方法

Webアプリケーション、静的サイトジェネレーター、社内自動化スクリプトなどにMarkdown→HTML変換を組み込む場合は、PythonやJavaScriptの定番ライブラリを利用します。

Pythonで変換する(Python-Markdown)

Pythonでは定番のmarkdown(Python-Markdown)ライブラリを使用します。標準状態では表(テーブル)やバッククォート3つのフェンスドコードブロックが有効になっていないため、extensions=['fenced_code', 'tables'](または一括バンドルの'extra')を指定するのが実務上のポイントです。

# インストール: pip install markdown
import markdown

md_text = """# 見出し

| 項目 | 内容 |
| --- | --- |
| 形式 | HTML |

```python
print("Hello, Markdown!")
```
"""

html = markdown.markdown(md_text, extensions=["fenced_code", "tables"])
print(html)

JavaScript(Node.js)で変換する(marked / markdown-it)+XSS対策

JavaScript・Node.js環境では、高速で軽量なmarkedまたは拡張性の高いmarkdown-itがよく使われます。

// 1. marked の例(ブラウザ環境: npm install marked dompurify / Node.js環境は isomorphic-dompurify 等を併用)
import { marked } from "marked";
import DOMPurify from "dompurify";

const rawHtml = marked.parse("# タイトル\n\n**太字テキスト**");
// ユーザー入力など信頼できないMarkdownを扱う場合はサニタイズを行う
const safeHtml = DOMPurify.sanitize(rawHtml);

// 2. markdown-it の例(npm install markdown-it)
import MarkdownIt from "markdown-it";

const md = new MarkdownIt({ html: false, breaks: true });
const result = md.render("# タイトル\n\n改行テスト");

重要:JavaScript実装におけるXSS(サニタイズ)対策

markedは出力HTMLのサニタイズを行わず、以前のsanitizeオプションもすでに削除されています。外部ユーザーが投稿したMarkdownをWeb画面へ描画する場合は、DOMPurifyなどのサニタイザーを併用して<script>タグや不正なイベント属性を無害化することが推奨されます。markdown-itも初期設定(html: false)では生HTMLをエスケープしますが、html: trueを有効にする場合や外部プラグインを追加する場合は同様にサニタイザーの併用が推奨されます。

HTML変換時のよくある崩れ・注意点と対処法

MarkdownをHTMLに変換したあと、「プレビューと見た目が違う」「意図しないレイアウトになった」という場合に確認すべき3つのチェックポイントをまとめました。

  • 1. 生HTMLタグの扱い(エスケープされる/無視される):Markdownパーサーによってはセキュリティ上、本文中に書いた<details>や<div>などの生HTMLタグをそのまま文字列としてエスケープ(&lt;div&gt;化)することがあります。HTMLタグを有効にしたい場合は、markdown-itのhtml: true設定などパーサー側のオプションを確認してください。
  • 2. 改行が反映されない(1行改行が半角スペースになる):CommonMark仕様では、単なる1回の改行は同じ段落内のスペースとして扱われます。強制改行(<br>)にしたい場合は「行末に半角スペース2つ」を入れるか、パーサーのbreaks: true(GFMのハードブレーク相当)を有効にしてください。
  • 3. 表(テーブル)やコードブロックの装飾が当たらない:Markdownから変換した直後の素のHTMLにはCSSが含まれていないため、<table>に枠線が出なかったり、<pre><code>に背景色が付かなかったりします。配布用HTMLにはgithub-markdown-cssなどのスタイルシートやPandocの-cオプションでCSSを適用しましょう。

HTMLからMarkdownへの逆変換方法とFAQ

既存のWebページやCMSのHTML記事をMarkdown形式へ戻したい(逆変換したい)ケースも少なくありません。以下のツール・ライブラリを使うと高精度にMarkdownへ戻せます。

  • Pandoc(CLI):pandoc input.html -f html -t gfm -o output.md を実行すると、HTMLからGitHub Flavored Markdownへ一発で逆変換できます。
  • Turndown(JavaScript):ブラウザ・Node.jsの両方で動作する定番のHTML→Markdown変換ライブラリです。
  • markdownify(Python):Pythonスクリプト内でHTML文字列をシンプルなMarkdownへ変換したい場合に便利です。

よくある質問(FAQ)

Q. MarkdownからHTMLに変換したあと、メール(Gmailなど)にそのまま貼れますか?
A. メールクライアントは外部CSSや<style>タグを無視・削除することが多いため、HTMLファイルをブラウザで一度開いて表示結果をコピー&ペーストするか、インラインCSS(各タグのstyle="..."属性)に変換してから貼り付けると崩れにくくなります。

Q. 変換後のHTMLファイルで日本語が文字化けする場合はどうすればよいですか?
A. HTMLの<head>内に <meta charset="UTF-8"> が含まれているか、また元の.mdファイルの文字コードがUTF-8で保存されているかを確認してください。Pandocの-sオプションやVS Code拡張機能を使えば標準でUTF-8が出力されます。

まとめ

MarkdownをHTMLに変換する方法は、作業環境と目的に合わせて選ぶのが最も効率的です。

  • インストール不要で今すぐ試す:DillingerやStackEditなどのオンラインツール(機密情報は入力しない)
  • 普段のエディタから1クリックで書き出す:VS Codeの「Markdown All in One」や「Markdown PDF」
  • CSS適用や複数ファイルの一括変換:Pandocの -s / -c / --embed-resources コマンド
  • Webアプリ・システムへの組み込み:Python-Markdownやmarked / markdown-it(DOMPurifyによるXSS対策を徹底)

まずは手元の環境で最も導入しやすい方法から試し、必要に応じてPDF変換やWord変換など他の出力フォーマットとも組み合わせてドキュメント作成を効率化してみてください。

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です