ブラウザだけで Markdown を HTML に変換する

なぜ重要か

チームは Git で Markdown を書く一方、企業 CMS はサニタイズ済み HTML 断片しか受け付けません。サポートはフェンス付きコードを貼るが、バックエンドがフィルタで落とします。マーケは Markdown で素早く草案を書き、メールテンプレ担当には HTML が必要です。ローカルで変換すれば、機密草案を怪しい「無料 MD→HTML」に流さずに済みます。

実際の3つのシーン

手順

Markdown → HTMLを開きます。

1. 1

   よく使う記法で書く

   見出し、リスト、リンク、フェンスコード、引用など。CMS の許可リストに無い拡張は避けます。

2. 2

   レンダーオプションを選ぶ

   公開先が GitHub Flavored に近いならテーブルや取り消し線などを有効化します。

3. 3

   プレビューを確認

   ネスト、裸 URL の自動リンクなど、期待どおりか見ます。

4. 4

   HTML をコピー

   Node が無いマシンでもその場で納品できます。

## Rollout checklist
 
1. Enable **feature flag** `payments.v2`
2. Monitor `/health/payments` for 15 minutes
3. Run: kubectl rollout status deploy/payments-api

<h2>Rollout checklist</h2>
<ol>
<li>Enable <strong>feature flag</strong> <code>payments.v2</code></li>
<li>Monitor <code>/health/payments</code> for 15 minutes</li>
<li>Run: kubectl rollout status deploy/payments-api</li>
</ol>

実践のヒント

• レビューは Markdown 同士の テキスト比較の方が diff が読みやすい。
• JSON やテンプレへ埋める前は エスケープで特殊文字を処理。
• CMS に CSP があるならインライン <style> に依存しない。

よくある落とし穴

向いていない用途

• サイト全体の静的パイプライン：Eleventy や Astro の方がディレクトリ単位の機能が揃います。
• メール HTML：インライン CSS とテーブルレイアウトが別途必要です。
• 組版レベルの PDF：LaTeX などが適しています。

FAQ

次のステップ

1. JSON ペイロードは先に フォーマッター。
2. 見出しの casing は ケース変換。
3. 抜粋の長さは 字数カウント。