2026-05-19 · 読了目安 1 分
ドキュメントサイト向け Markdown から HTML
プレビュー用に prose を変換; 本番 HTML は静的サイトジェネレーターを実行。
MarkdownHTMLドキュメント
重要ポイント
- 表、脚注、カスタムコンポーネントは SSG と異なる場合がある — 出力は近似とみなす。
- Web でユーザー Markdown をレンダリングする場合は HTML をサニタイズ。
プレビューワークフロー
Markdown で下書きし、ステークホルダープレビュー用に HTML に変換、レビュアーがインデントを必要とすれば HTML を整形。
JSON API レスポンス内にプレビュー HTML を埋め込むときは HTML エンティティをエスケープ。
よくある質問
CommonMark 準拠ですか？
一般的なブログ/ドキュメント構文を対象とし、すべての拡張ではない。レンダラーで確認。
HTML から Markdown に逆変換？
シンプルなページはサポート; 複雑なレイアウトは手動クリーンアップが必要。