PowerPointをSlidevのコードに落とす|抜くもの、画像に任せるもの

Hero banner with bold Japanese headline about turning a company's PPTX into code, SIOS Tech.Lab logo top right, decorative colors and tags beneath

ども!会社のPowerPointを解析して、Slidev側に持ってくる検証をしている龍ちゃんです。

会社の資料って、1枚1枚に職人芸が効いてるんですよね。ここはこの位置に、ここはこの大きさで、という判断が積み重なって、見やすい形になってる。あの詰め方は正直すごいと思ってます。

ただ、取り回しはよくない。開くとppt/media/に画像が148枚も入ってたりするし、中身をのぞいても座標の数字がずらっと並んでいるだけで、AIに手伝ってもらうにはちょっと解析しにくいんですよね。

僕の場合はというと、会社で発表するとき資料は会社のテンプレで作るので、ふだんSlidevで書いてる分を毎回作り直してました。同じ内容を二回作ってるのが地味に面倒で。

だったら逆をやればいいんじゃないかと思ったんです。会社のPowerPointを解析して、Slidev側に引っ張ってくる。会社のテンプレがSlidevのテーマになってしまえば、作り直す側が消えるはずだなと。

結論から言うと、会社のPowerPointはSlidevに移せます。雑に頼んでもけっこう移りますが、決まってこけるところがあります。読み終わる頃には、手元の.pptxを自分のClaude Codeに解析させて、Slidevに載せられる状態になっているはずです。指示の考え方まで含めて書いていきます。

雑に投げてもけっこう動く。ただ、決まって同じところでこける

スライドを画像にして「これをSlidevで再現して」と渡すだけでも、かなり形になります。まずは投げてみればいい、というのが最初の感触でした。

元のPowerPointのスライドと、それをSlidevに書き起こしたものを並べた画像

なお記事に貼っている画像は、公開できる方のテンプレで同じ手順を試したものです。数字のほうは会社の実資料で測っているので、そこは別物として読んでもらえると助かります。

指示をほとんど渡さなくても、この調子でそれなりに動きます。

元のPowerPoint・指示なしで書き起こしたもの・4つの要求を渡して書き起こしたものを、縦に3段で並べた比較画像

真ん中の「指示なし」を見てもらうと分かるんですが、これでも十分読めるスライドになっています。

で、この調子で何枚か試していくと、決まって同じところでこけました。AIに何かを再現させたことがある人なら、たぶん見覚えがあると思います。

  • 日本語と英語の間に、なぜか半角スペースが入っている
  • 見た目は合っているのに、直そうとしたら手が入らない
  • 文字が画像になっていて、打ち直せない
  • 材料を足したのに、かえって悪くなった

この4つ、理由はひとつで説明つきます。AIが見た目に合わせにいっているんですよね。

いちばん分かりやすいのが、日本語と英語の間の空白です。

3段比較の先頭2行だけを拡大した画像。指示なし側は日本語と英語の間に半角スペースが入っている

元のPowerPointを見ると、たしかに空いて見えます。ただ、これ文字じゃないんですよ。PowerPointが描くときに自動で空けているだけで、XMLから抜いた原文にスペースは入っていません。あとからAIが自分で書いた「迷ったところ」を読んだら、PowerPointの和欧文オートスペースに寄せる意図でやった、と書いてありました。事故じゃなくて、気を利かせた結果なんですよね。

見た目は合っているのに直せないやつ、これは中を見ると全部が座標でベタ置きされています。文字が画像になっているのも同じで、どちらも見た目を合わせる最短経路なんですよ。元と同じ位置に置きたいなら座標がいちばん確実だし、元と同じ字面にしたいなら絵にして貼るのがいちばん確実です。

材料を足したら悪くなった、というのも同じ動機でした。図形の座標や入れ子まで渡すと、渡した分だけ「その通りに並べる」側へ寄っていくんです。渡した量の問題ではなくて、渡したものの種類の問題ですね。

並べ直したら、移すものは3つに分かれた

じゃあ何をどう渡せばいいのか。詰めていくと、そもそも移すものが3つに分かれることが見えてきました。

  • コードから抜くもの
  • 画像に任せるもの
  • 再現しないもの

1枚のスライドに重ねると、こういう分かれ方です。

1枚のスライドを3色で塗り分けた図。ヘッダの帯とロゴ、フッターが「コードから抜く」、本文のカード2枚を含む領域が「画像に任せる」、カード頭の小さなアイコンが「再現しない」と示されている

ひとつずつ見ていきます。なお、抜く作業自体はここも全部Claude Codeに投げます。python-pptxとOOXMLの直読みで、一発で抜けます。

コードから抜く:文字と寸法と、繰り返し出てくるもの

文字と、寸法と、全ページで共通のパーツです。

共通パーツはロゴ・帯・罫線・フッター。これはレイアウト側に置いてあるので、レイアウトだけ見れば済みます。指示は「レイアウトからの参照回数で共有アセットを特定して」。ファイル名でも見た目でもなく、回数で当てるのがポイントです。会社の実資料はロゴが24のレイアウトから参照されていて、公開用テンプレでも8のレイアウトから参照されていました。数えれば一発で出てきます。

帯や罫線やロゴまわりの色もここです。抜いて、Slidev側のテーマに焼いておきます。

ちなみに、色を数えていて面白かったこと。本文スライド43枚で直接指定されている色が44種類あって、しかも目で見て区別がつかない組み合わせが5つ出てきました。たとえば黒。#000000が17回で、その隣に、ほぼ黒だけど黒じゃない#050100が25回。本物の黒より多いんですよ。

これ、わかるわーってなりましたね。43枚を手で作れば黒が2種類になるのは当たり前で、責める話じゃないです。むしろ人間やなーと。揃っている値は機械が作ったもので、散っている値は人が判断した跡なんですよね。

寸法も同じ束で、図形の座標はEMUという単位で入っているので、スライドの判型で割れば%になります。Slidev側はCSSなので、%にしてしまえばそのまま置けます。

文字は1枚ずつ抜きます。ここで注意がひとつあって、XMLの並び順は読み順ではありません。重なりの前後関係でしかないので、素直に上から抜くと見出しと本文が入れ違って出てきます。だから指示には「図形の上端の座標で並べ直してから出して」まで入れておく必要があります。

画像に任せる:本文の中の見た目

本文の中の見た目です。配置とか、余白とか、その辺。

ここ、「抜かなくていい」というより、画像側が担当してくれるから抜かないという話なんですよね。Slidevをずっと触ってきた実感として、画像を見せて見た目を再現させる部分に関しては、かなり強いと思ってます。実際、ブランドの色まで抜いて一緒に渡してみたこともあるんですが、出てくるものは変わりませんでした。抜く工程がまるごと要らなかった、ということです。

面白いのは、抜くか任せるかの線が素材の種類では引かれていないことです。同じ「色」でも、レイアウトに書いてあるブランドの色は抜くし、本文の中の色は任せる。どこに書いてあるか、何のための値か、で分かれます。

再現しない:ページごとの装飾

イラスト、飾りのアイコン、切り貼りされた画像。ページごとに乗っている装飾です。

ここは忠実に再現しにいかないほうがいいです。PowerPointのグループ機能をそのまま持ってくればいいかと思って開けてみたんですが、中身はアイコンを構成するパスの集まりでした。意味のまとまりではなく、絵の部品なんですよね。これをCSSに翻訳しても、手間の割に何も残りません。

判断は共有パーツと同じで、回数で決めます。何ページにも繰り返し出てくるなら、それはレイアウト側の持ち物なので、抜いてテーマに焼く。そのページにしか出てこないなら、それはそのページの飾りなので、再現しない。必要なら画像のまま置いて、先に進みます。

忠実に再現しないと決めるところが、たぶん一番大事です。見た目だけ合わせたいなら画像を貼るか座標でベタ書きすれば済みますし、実際そのほうが元と一致します。でもそれだと、あとから直せないし、他のスライドのお手本にもなりません。

抜く、任せる、再現しない。この3つでだいたい片付きます。

ただ、どれをやっても出てこないものがひとつだけ残ります。その1枚の中で、どれとどれがひとまとまりなのか、どこを強く見せたいのか。スライドの設計です。ここはファイルのどこにも書いていないので、自分の言葉で渡すしかありません。

逆に言うと、さっき「見た目に合わせにいく」で説明したこけのほうは、こちらが任せる範囲を決めていなかっただけなんです。決めていないから、任せた側が倒れた。

渡すのは2点。あとは要求文を4つ

というわけで、渡すものは決まりました。レンダ画像と、XMLから抜いた文字の2点セットです。

画像だけだと文字が必ず崩れます。さっきの和欧間のスペースですね。毎回まったく同じところが崩れたので、これは偶然じゃなくて性質です。文字をテキストで渡してあげれば直ります。画像を渡すのが効くこと自体は以前AIに「なんか違う」が伝わらない?画像を渡して指示ループから抜け出すで書いたんですが、スライドの書き起こしでは画像だけだと足りません。

逆に、ここから材料を増やしても構造は出てきませんでした。動いたのは頼み方のほうです。

こちらが満たしてほしいことを4つ、そのまま文章にして渡してみました。

  1. 文字は必ず文字として置くこと。画像やSVGの中に焼き込まない
  2. 見た目のまとまりは、そのまま入れ子で表すこと。座標で位置を合わせて並べない
  3. テーマがすでに描いているもの、ロゴや罫線やフッターは描き足さないこと
  4. 本文領域の中で、いちばん小さい文字が13pxを下回らないこと

判定に使いたい軸を、そのまま要求文に翻訳した形です。全文は付録に置いておくので、手元でそのまま使ってもらえます。

構造がまったく違う2枚で試して、狙ったことは全部通りました。まあ割と通るよねって感じです。

ただ、効き方がちょっと意外でした。構造そのものは、頼まなくても出てくることがあるんです。何も言わなくても表をtableとtrで組んでくれたりします。じゃあ指示は何をしたのかというと、逃げ道を塞いでいました。座標で位置合わせをする回、文字をSVGや背景画像に焼き込む回。何も言わないとこの2つが混じるんですが、4つを渡した回はどちらもゼロになりました。

それでもこけたときは、こう考えると仕分けられます。そのスライドを、人間がファイルの中身だけ見て復元できるかどうか。できないなら、AIにもできません。できるはずなのに出てこないなら、任せる範囲を決めていないだけなので、頼み方で直ります。

ついでに、こけたわけじゃなくて割り切ったものも書いておきます。配置は原本とずれますが、これはずれていいと思ってます。構造として組み直す以上ずれるので、移した先で調整するのが前提です。変換ツールも作っていませんし、いちばん複雑な1枚はまだ試せていません。

じゃあ、何から始めればいいのか

最初の一手は決まっていて、全部を移す計画は立てなくていいです。1枚だけ、レンダ画像と抜いた文字を渡して投げてみてください。最初の「まず投げてみればいい」に戻ってくる話です。

レンダ画像は、PowerPointから画像で書き出すのがいちばん早いです。文字は<a:t>から抜いて、図形の上端の座標で並べ直してから渡します。どちらも作り方を付録に書いておきました。

こけたら、さっきの仕分け方を使ってください。人間がファイルの中身だけ見て復元できるものがこけていたら、任せる範囲を決めていないだけなので、要求文を足します。付録の全文をそのまま持っていってもらえます。復元できないものなら、それはファイルに答えがないので、諦めてAIに書かせてください。特に設計のところは、自分の言葉で渡してあげるのが結局いちばん早いです。

そこまで移してしまうと、あとがけっこう楽になります。エンジニアが慣れている形式で管理できるし、コードになっているぶんAIも読める。重いPPTXを持ち歩かなくてよくなって、職人芸だった資料が、あとから読めるお手本になります。スライドをコードで書くこと全般の利点でもあるので、Marp と Slidev の使い分けにも近い話を書きました。

SlidevからPowerPointへ、という向きも検証してあります。Slidevで作った資産をそのままPowerPointへ持っていく話はSlidevのスライドを、手で組み直さずに編集できるPPTXにする、中身だけ会社のテンプレへ流し込む話はSlidevの中身を、会社のPowerPointテンプレのレイアウトへ流し込むに書きました。

会社のテンプレが手元になくて、自分のデザインから起こしたい人はPowerPointテンプレが無いなら、Slidevのデザインから自作する。道の全体像はSlidevからPowerPointへ渡す道を整理した記事にまとめてあります。

まぁ割と通るよね、AIって優秀です。

次はもう一段上をやりたいと思ってます。1枚の中じゃなくて、デッキ全体のほう。どの順で見せているのか、この枚は読ませたいのか、インパクトを与えたいのか、流れで持ち帰らせたいのか。デザイン込みのストーリーラインまで解析できたら面白いなと思っていて、ここはまだ手をつけていません。

付録:手元で再現するための情報

要求文の全文

4つの要求をそのまま文章にしたものです。手元の.pptxで試すときは、これをそのままAgentに渡してください。

## このスライドをSlidevで書き起こしてください

渡した画像のスライドを、Slidevのコード(`slides.md` + 必要なら scoped CSS / Vue コンポーネント)として書き起こしてください。成果物はコードです。画像を貼って済ませないでください。

以下の4つを満たしてください。

### 1. 文字は必ず文字として置く

- 画面に見えている文字は、すべて DOM のテキストノードとして存在させてください。
- 画像・`<svg><text>`・CSS の背景画像に文字を焼き込まないでください。後から打ち直せなくなります。
- 渡したテキストがある場合は、そこから一字一句そのまま使ってください。画像から読み取った文字で上書きしないでください。

### 2. 見た目のまとまりを、そのまま入れ子で表す

- スライドの上でひとまとまりに見えるもの(カード、行、ステップ、表の1行、アイコンと見出しと本文の組など)は、1つの親要素の中に入れ子にしてください。
- 判断の基準は「これを掴んで動かしたら、中身がまとめて付いてくるか」です。付いてこない書き方になっていたら、まとまりが表現できていません。
- 座標で位置を合わせて並べる書き方を避けてください。`position: absolute` と `top` / `left` で1つずつ置いていくと見た目は合いますが、そのスライド専用のコードになって使い回せません。
- 代わりに、要素の入れ子と、flex / grid / 通常の文書フローで組んでください。

### 3. テーマが描くものを描き足さない/本文の領域から出ない

- ロゴ、ヘッダの罫線、フッターのコピーライト、ページ番号はテーマがすでに描いています。同じものを本文の中に描き足さないでください。
- ページのタイトルは frontmatter の `heading:` に渡してください。本文の中に見出しとして書かないでください。
- 描いてよいのは `default` レイアウトの slot(本文領域)の中だけです。この領域は `overflow: hidden` なので、はみ出した分は切れます。
- 文字が溢れたり、途中で切れたりしない状態にしてください。

### 4. 読める大きさで置く

- 本文領域の中で、いちばん小さい文字が 13px を下回らないようにしてください。
- 縮めて詰め込むより、入る量に収めることを優先してください。

## 組み立てに使ってよい部品

以下の語彙で組んでください。ここに無いものを使ってはいけない、という意味ではありませんが、まず以下で表せないかを考えてください。

| 部品 | 使う場面 |
|---|---|
| 見出し(`h2` / `h3`)+ 本文(`p`) | 小見出しと説明の組 |
| 箇条書き(`ul` / `ol` / `li`) | 並列する項目、入れ子の項目 |
| 表(`table` / `tr` / `td`) | 行と列で読ませるもの。行は必ず `tr` にする |
| カード(`div` などの囲み) | 枠線や背景色で囲まれたまとまり |
| 横並び(`flex`) | アイコンと文章、2つのブロックの左右並び |
| 格子(`grid`) | 3つ以上が規則的に並ぶもの |

- 同じ形が繰り返し出てくるなら、Vue コンポーネントに切り出して使い回してください。
- CSS は scoped で書いてください。

## 出力の形

1. `slides.md`(frontmatter に `layout: default` と `heading:` を含む)
2. 必要なら Vue コンポーネントと scoped CSS
3. 迷ったところ・妥協したところを最後に箇条書きで書いてください(何が難しかったかを知りたいので、うまくいったふりをしないでください)

素材の作り方

渡す2点セットのうち、レンダ画像はPowerPointから画像で書き出すのがいちばん早いです。手元にPowerPointがある人はそれで足ります。僕はdevcontainerの中でやっていたので、LibreOfficeでPDFにしてから画像にしました。ただしこの環境にはメイリオが無くて、LibreOfficeがNoto Sans CJKで代替してレンダします。字形は変わるので、フォントまで見たいならPowerPoint側から書き出したほうが確実です。

文字は<a:t>から抜いたあと、図形の上端の座標で並べ直してから渡します。XMLの並び順のままだと入れ違うので、ここは省けません。寸法はEMUという単位で入っているので、スライドの判型で割って%にします。Slidev側はCSSなので、%にしてしまえばそのまま置けます。

ロゴ・帯・罫線の実測値

ロゴはレイアウト側からの参照回数で特定します。会社の実資料は同じファイルが24のレイアウトから、公開用テンプレは8のレイアウトから参照されていました。透明パディングの実測は、会社の実資料が上下28%・左右11.5%、公開用テンプレが上下10%・左右0.1%です。アルファのbboxでタイトクロップしてから配置します。

こちらは公開用テンプレだけの実測値です。会社の実資料は参照回数と透明パディングしか測っていないので、対比にはなっていません。

項目実測値
帯の高さ13.0%
罫線0.7%
ロゴの上端4.1%

踏んだ罠

  • <style>の中のCSSコメントに<br>と書くとSlidevのビルドが落ちます
  • frontmatterのtitleは予約語なのでレイアウトに渡りません。別のキー(heading:など)にします
  • <img>のwidthとrightは既定テーマのCSSに上書きされます。divで包んで、div側で幅を決めます

測り方

slides.mdの文字列を読むだけだと、Vueコンポーネント越しに生成されたものが測れません。ビルドしてレンダーしたあとのDOMから取る必要があります。

ではまた!

ご覧いただきありがとうございます! この投稿はお役に立ちましたか?

役に立った 役に立たなかった

0人がこの投稿は役に立ったと言っています。
エンジニア募集中!

コメントを残す

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