md-to-html

name	md-to-html
description	Markdown を共通テーマの HTML（画面ダーク / 印刷は A4 ライトテーマ）に変換する。「HTML 化して」「HTML 版を作って」「PDF にしたい」で起動。調査/設計/レポート md の配布・印刷用途に。素早く出すなら scripts/render-html.sh、リッチな card/box レイアウトが要るときは LLM 整形。
user_invocable	true
argument_hint	<markdown-file-path> [--rich] [--sync]
origin	ai-research-pipeline/.claude/skills/md-to-html (PR

md-to-html スキル (Stage 2)

md→HTML→slide パイプラインの Stage 2。md (正) を共通テーマの HTML (派生) に変換する。 画面表示はダークテーマ、印刷 (PDF 化) 時は A4 ライトテーマに自動で切り替わる。

前段の readable-md (Stage 1) で構造を整えた md を入力に想定する （H1 単一・見出し非スキップ・frontmatter 付き）。

基本原則

MD が正 (Source of Truth)

*.md (正)  →  変換  →  *.html (派生)
  ↓ 修正                    ↓ 再生成
*.md (更新) →  変換  →  *.html (更新)

• 内容修正は 常に MD 側。HTML は派生表示用で、HTML だけの手修正はしない（同期が壊れる）。
• 出力先は既定で MD と同じディレクトリの同名 .html。

スタイルは asset が唯一の正

CSS/デザイントークンは assets/report-theme-head.html に集約。 HTML 生成時はこの <style> ブロックを 逐語コピーして に挿入する。 SKILL.md 本文や生成 HTML に独自 CSS を散らさない（ドリフト防止）。テーマ変更は asset 側だけ編集。