MarpやMarkdownからスライドへ|PowerPointで直せる形が要るかで選ぶ

Marp と Slidev がふつうに書き出す PPTX はスライドの画像で、文字を直せません。PowerPoint で直せる形にする方法と、その限りを、Marp・Slidev・reveal.js・Pandoc の公式の説明で比べます。

この記事をシェア:
目次 クリックで開く

この記事の要点

  1. Markdown からスライドを作る道具には、Marp(VS Code の拡張で始められる)、Slidev(Vue で動くデモを入れられる)、reveal.js(HTML のページに組み込む)、Pandoc(文書の変換)があり、どれも HTML か PDF を作れます。
  2. 分かれるのは PowerPoint のファイルで渡すときです。Marp と Slidev の通常の PPTX はスライドを画像にしたもので、文字を直せません。直せる形は、Marp の実験的な機能、Slidev の pptx-editable(2026年9月の v52.20.0 から)、Pandoc で作れます。
  3. 受け取る人が PowerPoint で見た目まで直して仕上げる資料は、どの道具でも PowerPoint で組んだものと同じには仕上がりません(再現できない要素や、選べないレイアウトがあります)。会社の PowerPoint のテンプレートから組む方法と比べて選んでください。

同じ作例の資料を、4つの道具で PowerPoint に書き出すと

Marp

VS Code の拡張と Marp CLI

  • 通常の PPTX:スライドを画像にして貼る。文字は直せない
  • –pptx-editable:文字・図形を直せる形。実験的な機能で、LibreOffice が要り、発表者のメモは入らない

Slidev

Node.js のプロジェクト(Vue・Vite)

  • –format pptx:画像。文字は選べない
  • –format pptx-editable(コマンドだけ):PowerPoint の図形と文字で組み直す。Mermaid の図・数式などは画像のまま。メモは入る

reveal.js

HTML のページ

  • 公式の書き出しの手順は、ブラウザの印刷での PDF
  • PPTX の書き出しは手順に無い

Pandoc

コマンドラインの変換の道具

  • 見出しと本文を PowerPoint のレイアウト(Title and Content など)に流し込む
  • 会社のテンプレートを –reference-doc で指定できる。数式は PowerPoint の数式になる

出典:Marp CLI の README、Slidev「Exporting」、reveal.js「PDF Export」、Pandoc User’s Guide「Slide shows」

この記事では、Markdown でスライドを書く道具のうち Marp、Slidev、reveal.js、Pandoc の4つを比べます。どれも Markdown から HTML か PDF の資料を作れるので、自分で発表するだけなら、書きやすさと見せ方で選んで構いません。迷うのは、相手から「PowerPoint のファイルでください」と言われたときです。

当社は業務の自動化や生成AIの導入を手伝う会社で、このブログでは PowerPoint をスクリプトで作る方法も書いています。この記事は、技術の説明や社内勉強会の資料を Markdown で書きたい技術者に向けて、4つの道具が何を書けて、PowerPoint にどんな形で出せるかを、各プロジェクトの公式の説明で確かめてまとめたものです。Google スライドへの取り込みと、有料のスライド作成アプリは扱いません。

比べるために、作例を1つ決めます。社内勉強会で使う数枚の資料で、表紙、強調したい行があるコード、処理の流れの図(Mermaid という、文字で図を書く記法)、数式が1つずつ入るものとします。説明のための作例で、実在の資料ではありません。この4つが、道具ごとにどう書けて、PowerPoint にどう出るかを順に見ます。

4つの道具の違い
道具(確かめた版)動かすのに要るもの書き出せる形PPTX の中身ライセンス
Marp(Marp CLI 4.5.1、VS Code 拡張 3.6.1)VS Code の拡張だけでプレビューできる。PDF・PPTX・画像にはブラウザ(Chrome・Edge・Firefox)が要るHTML、PDF、PPTX、PNG・JPEG、発表者メモのテキスト通常は画像。実験的な機能で直せる形も作れるMIT
Slidev(53.0.0)Node.js 22.12.0 以降。コマンドで PDF・PPTX・PNG にするには playwright-chromiumWeb(SPA)、PDF、PPTX、PNG、Markdown通常は画像。v52.20.0 から直せる形も作れるMIT
reveal.js(6.0.2)ブラウザだけでも動く。外部の Markdown ファイルを読むにはローカルのWebサーバーHTML。PDF はブラウザの印刷で公式の手順に無いMIT
Pandoc(3.12.1)Pandoc の本体(beamer の PDF には LaTeX も)PPTX、reveal.js などの HTML、beamer の PDF ほかPowerPoint のレイアウトに流し込むGPL v2 以降

出典:Marp CLI・Marp for VS Code・Slidev・reveal.js・Pandoc の公式の説明と、各リポジトリのライセンスの表示

Marp:VS Code の拡張だけで書き始められる

Marp では、VS Code の拡張「Marp for VS Code」を入れ、Markdown ファイルの先頭の設定(front-matter)に marp: true と書くと、そのファイルがスライドとして扱われます。プレビューは VS Code の通常の Markdown のプレビューと同じ開き方です。作例を Marp で書くと、次のようになります。

Marp の作例(presentation.md)

---
marp: true
theme: default
paginate: true
math: katex
header: 社内勉強会(作例)
style: |
  section { font-family: "Noto Sans JP", sans-serif; }
---
# ログの集計を速くする
<!-- 話すこと:自己紹介と今日の範囲 -->
---
<!-- _class: invert -->
## 1. 今日の話
- 今の集計の流れ
- 変えたところ
<!-- 話すこと:変える前に困っていたこと -->
---
## 2. 変えたコード
```ts
const rows = await fetchRows();
const total = rows.reduce((s, r) => s + r.ms, 0);
```
---
## 3. 平均の出し方
平均は $\bar{x} = \frac{1}{n}\sum x_i$ で出します
<!-- 話すこと:外れ値の扱い -->

スライドは --- の行で区切ります。paginate・header は「ディレクティブ」と呼ぶ設定で、front-matter に書くと全ページに効きます。<!-- _class: invert --> のように名前の前に _ を付けると、そのページだけに効きます(invert は Marp の組み込みテーマで色を反転させるクラスです)。ディレクティブ以外の HTML コメントは、発表者のメモとして集められます(Marpit「Directives」、「Presenter notes」)。

見た目は CSS で変えます。Markdown の中に <style> を書く方法と、作例のように front-matter の style: に書く方法があります。<style> はほかの Markdown エディタで開くと表示を崩すことがある、と公式は書いています。1ページだけに効かせるなら <style scoped> です(Marpit「Theme CSS」)。会社のテーマを作るなら、テーマの CSS ファイルをリポジトリに置きます。VS Code では設定 markdown.marp.themes、Marp CLI では --theme-set で同じファイルを指すと、書く人の画面と書き出す仕組みで同じ見た目になります。

作例の数式・コード・図は、どこまで書けるか

数式は $...$ で文中に、$$...$$ で1行に大きく出せます。描く仕組みは既定で MathJax で、math: katex と書くと KaTeX に切り替わります。公式は、数式を使うなら math で使う仕組みを宣言することを勧めています(Marp Core v4 の README)。

コードの色分けはできますが、作例の「強調したい行」と「処理の流れの図」は、2026年10月時点の安定版(Marp Core v4)では書けません。Mermaid の図を描く機能と、{1,3-5} のように行を指定して強調する機能は、Marp Core の v5(2026年8月7日に v5.0.0)で加わりました。ただし v5 はリリース候補で、npm では next の扱いです。VS Code 拡張 3.6.1 が使うのは v4 系です。Marp CLI 4.5.1 も v4 系を使い、プロジェクトに Marp Core v5 を入れた場合にだけ、v5 の全部入りの版を優先して使います(Marp Core の変更履歴、Marp CLI の変更履歴)。VS Code の拡張で作例を作るなら、流れの図は別の道具で画像にして貼ります。

VS Code から書き出す、コマンドで書き出す

VS Code では、ツールバーの Marp のアイコンから「Export slide deck…」を選びます。書き出せるのは HTML、PDF、PPTX、PNG と JPEG(1枚目だけ)、発表者メモのテキストです。PDF・PPTX・画像には、Google Chrome、Chromium、Microsoft Edge、Firefox のどれかが入っている必要があります。VS Code に組み込みの AI エージェントにも、チャットで書き出しを頼めるようになっています(Marp for VS Code の README)。

全ページを画像にしたいときや、まとめて書き出したいときは Marp CLI を使います。Node.js 18 以降で動き、Node.js を入れたくなければ公式のコンテナイメージか、Node.js を同梱した単体の実行ファイルも使えます(Marp CLI の README)。

Marp CLI のコマンド(PDF、PPTX、全ページの PNG、保存するたびに書き出す)

npx @marp-team/marp-cli@latest presentation.md --pdf
npx @marp-team/marp-cli@latest presentation.md --pptx
npx @marp-team/marp-cli@latest presentation.md --images png
npx @marp-team/marp-cli@latest -w presentation.md

Marp の PPTX は2種類あり、ふつうに書き出すと画像になる

Marp CLI の --pptx で作る PPTX は、PowerPoint、Keynote、Google スライド、LibreOffice Impress で開けます。画像がぼやけないよう、PPTX のときは既定で2倍の大きさで描きます。直せる形は --pptx-editable を足して作ります。2025年1月の v4.1.0 で入った実験的な機能です(Marp CLI の README、変更履歴)。

Marp CLI で直せる形の PPTX を作る

npx @marp-team/marp-cli@latest presentation.md --pptx --pptx-editable

README は、見た目を保つことが大事なら直せる形は勧めない、としています。VS Code では設定 markdown.marp.pptx.editable でこの機能を使えます。smart にすると、まず直せる形を試し、失敗したら通常の PPTX に切り替えます(Marp for VS Code の README)。

Marp の2つの PPTX

通常の PPTX(–pptx)

ブラウザがあれば作れる

  • 描いたスライドを背景の画像として並べる
  • 文字は直せない・使い回せない
  • 発表者のメモは入る

直せる PPTX(–pptx –pptx-editable)

ブラウザと LibreOffice Impress が要る。実験的

  • 文字・図形・画像を PowerPoint で直せる
  • 凝ったテーマ(例:gaia)ではエラーや不完全な出力になることがある
  • 見た目の再現は下がる
  • 発表者のメモは入らない

出典:Marp CLI の README「Convert to PowerPoint document」

作例でいえば、勉強会の後に資料を配るだけなら、通常の PPTX か PDF で足ります。受け取った人が数字や言い回しを直して使い回すなら、直せる PPTX を一度作り、PowerPoint で開いて崩れた所を確かめてから渡します。

Slidev:作例の4つを全部書けて、PPTX も直せる形を選べる

Slidev は、Vite・Vue 3・UnoCSS で作られた、Web で動くスライドの道具です。スライドの中に Vue のコンポーネントを置いて操作できるデモにしたり、Monaco エディタでその場でコードを書いたりできます。発表者用の画面と録画の機能も入っています。Node.js 22.12.0 以降が要ります(Slidev「Getting Started」)。

作例の4つは、Slidev なら追加の設定なしで書けます。コードの行の強調は言語名の後ろに {2} のように行番号を書き、{2-3|5|all} と書けば、クリックするたびに強調する行が移ります。Mermaid は mermaid のコードブロックがそのまま図になります。数式は KaTeX で $...$ と $$...$$ で書きます(「Line Highlighting」、「Mermaid Diagrams」、「LaTeX」)。

Slidev の作例(1枚分。行の強調と、最後のコメントが発表者のメモ)

## 2. 変えたコード
```ts {2}
const rows = await fetchRows();
const total = rows.reduce((s, r) => s + r.ms, 0);
```
<!-- 話すこと:2行目で集計の回数を減らした -->

Slidev の作例(1枚分。Mermaid の図)

## 3. 処理の流れ
```mermaid
graph LR
  A[ログ] --> B[集計] --> C[グラフ]
```

各スライドの最後のコメントが発表者のメモになります(「Syntax Guide」)。間違えやすいのは区切りの --- です。公式は前後に空行を入れた --- で区切るとしています(「Syntax Guide」)。--- の次の行が空でないと、そこから次の --- までをそのスライドの設定(frontmatter)として読みます(パーサーのソース)。この記事の作例は1枚ずつ載せていますが、つなげるときは区切りの前後を1行空けます。

Slidev の2つの PPTX

書き出しは、ブラウザで開いたスライドの「Export」の画面か、slidev export のコマンドで行います。Export の画面で作れるのは PDF と画像の PPTX(と画像の zip)で、直せる PPTX はコマンドでだけ作れます。コマンドで PDF・PPTX・PNG にするには、プロジェクトに playwright-chromium を入れます(Slidev「Exporting」)。

Slidev の書き出し(PDF、画像の PPTX、直せる PPTX、PNG)

npm i -D playwright-chromium
slidev export
slidev export --format pptx
slidev export --format pptx-editable
slidev export --format png

Slidev の書き出しは3つの出口で作れるものが違う

Export の画面

ブラウザで開いたスライドの More options

  • PDF
  • 画像の PPTX
  • 画像の zip

slidev export

コマンド。playwright-chromium が要る

  • PDF(既定)・PNG・Markdown
  • –format pptx:画像の PPTX
  • –format pptx-editable:直せる PPTX(コマンドだけ)

slidev build

コマンド

  • 静的な Web のページ(SPA)
  • 動くデモをそのまま見せられる
  • –without-notes でメモを外せる

出典:Slidev「Exporting」、「Building and Hosting」

--format pptx の PPTX は、全スライドが画像になり、文字は選べません。発表者のメモはスライドごとに入ります。クリックで段階的に出す動きは、既定で1段階ずつ別のページになります。

--format pptx-editable は、2026年9月16日の v52.20.0 で入りました(リリースノート)。ブラウザでスライドを測り、PowerPoint の図形と文字で組み直します。そのため、文字を選んで直せ、箱を動かしたり色を変えたりもできます。発表者のメモも入ります。ただし、PowerPoint に同じものが無い要素は画像のまま残ります。公式が挙げているのは SVG(Mermaid の図とアイコン)、canvas、iframe、動画、KaTeX の数式、CSS のグラデーションなどです。作例でいえば、表紙の文字とコードは文字のまま入り(コードの行番号は外れます)、処理の流れの図と数式は画像のまま入ります。画像になるのは、ふつうはその要素だけです。安全に組み直せないページや、組み直してもほぼ画像になるページは、そのページだけ画像の書き出しに戻り、理由が表示されます。公式が「最も見た目に忠実なのは --format pptx」と書いているとおり、通常の形を置き換えるものではありません。

渡す前に知っておくことも公式に書かれています。PPTX はフォントの名前を指すだけで、フォント自体は入れません。受け取った人のパソコンにそのフォントが無いと、PowerPoint が別のフォントに置き換えます。PowerPoint はブラウザと文字の測り方が違うので、長い段落は折り返しの行数が変わることがあります。テーマが ::before・::after で描いている飾りも外れます。

reveal.js:HTML のページの中で Markdown を使う

reveal.js は、HTML でスライドを作る仕組みで、Markdown は組み込みのプラグインで使います。<section> に data-markdown を付け、中の <textarea data-template> に Markdown を書きます。作例のコードのページなら、次のとおりです。

reveal.js の作例(1枚分。行の強調と発表者のメモ)

<section data-markdown>
  <textarea data-template>
## 2. 変えたコード
```js [2]
const rows = await fetchRows();
const total = rows.reduce((s, r) => s + r.ms, 0);
```
Note: 2行目で集計の回数を減らした
  </textarea>
</section>

[2] が行の強調で、[1-2|3] のように書けば段階的に移ります。Note: から後ろは発表者のメモです。既定のスライドの区切りは、1行に --- だけを書いた行です(reveal.js「Markdown」)。数式は Math プラグインで書け、KaTeX と MathJax 2・3・4 から選べます。KaTeX は既定でインターネット上から読み込むので、オフラインで使うなら手元に置いて local の設定で指します(「Math」)。組み込みのプラグインは Highlight・Markdown・Search・Notes・Math・Zoom の6つで、Mermaid の図はこの中に入っていません(「Plugins」)。

書き出しの公式の手順は PDF です。URL に ?print-pdf を付けて開き、ブラウザの印刷で、送信先を「PDF に保存」、向きを横、余白をなし、背景のグラフィックをオンにして保存します。公式は、この方法を確かめたのは Google Chrome と Chromium だけだとしています。コマンドで PDF にするなら、公式は decktape という別の道具を案内しています(「PDF Export」)。PPTX への書き出しは、公式の手順にはありません。npm で自分の Web のプロジェクトにも組み込めるので(「Installation」)、社内のポータルや Web のページの一部としてスライドを見せたいときに向きます。

Pandoc:PowerPoint のレイアウトに流し込む

Pandoc は、Markdown を Word・HTML・PDF などに変える文書変換の道具で、PowerPoint の .pptx も出せます。Markdown の見出しと本文を、PowerPoint のスライドのレイアウトに割り当てて組みます(Pandoc User’s Guide「Slide shows」)。

Pandoc のコマンド(PPTX にする、既定のテンプレートを書き出す、会社のテンプレートで PPTX にする)

pandoc slides.md -o slides.pptx
pandoc -o custom-reference.pptx --print-default-data-file reference.pptx
pandoc slides.md --reference-doc custom-reference.pptx -o slides.pptx

ページの分け方は見出しの階層で決まります。本文がすぐ続く見出しの階層(スライドの階層)の見出しと、横線が新しいスライドになり、それより上の見出しは区切りのスライドになります。表紙は Markdown の先頭の title・author・date から作られます。使うレイアウトは Title Slide、Title and Content、Section Header、Two Content、Comparison、Content with Caption、Blank の7つで、中身に応じて Pandoc が選びます。

会社の PowerPoint のテンプレートに合わせたいときは、--reference-doc でテンプレートを指定します。条件は、上の7つの名前のレイアウトがテンプレートの中にあることです。最近の PowerPoint に付いてくるテンプレートは、この条件を満たしています。足りない名前があると、Pandoc の既定のレイアウトで代わりに組み、警告を出します(「–reference-doc」)。発表者のメモは ::: notes で囲んだ部分が PowerPoint のノートに入ります。一方で、スライドの途中に間を入れる . . . は、PowerPoint ではまだ使えません。2列のレイアウトで列の幅を指定しても、PowerPoint では効きません。ライセンスは GPL v2 以降です(COPYRIGHT)。

作例でいえば、表紙は Title Slide に、見出しと箇条書きのページは Title and Content に入ります。数式は PowerPoint の数式(OMML)として出力されます(「Math」)。処理の流れの図は、別の道具で画像にしてから Markdown に貼ると、文字の後に画像が続くページとして Content with Caption のレイアウトで組まれます。

直せる PPTX の3つの作り方で、作例がどう入るか

Marp(–pptx-editable)

実験的。ブラウザと LibreOffice Impress

  • 文字・図形・画像を直せる
  • 発表者のメモは入らない
  • 凝ったテーマではエラーや不完全な出力のことがある
  • Mermaid の図は安定版(v4)では書けない

Slidev(–format pptx-editable)

v52.20.0 から。コマンドだけ

  • 文字・箱を直せる。コードの行番号は外れる
  • 発表者のメモは入る
  • Mermaid の図・KaTeX の数式は画像のまま
  • フォントは埋め込まない

Pandoc(-o slides.pptx)

PowerPoint のレイアウトに流し込む

  • 会社のテンプレートを –reference-doc で指定
  • 発表者のメモは ::: notes で入る
  • 数式は PowerPoint の数式(OMML)
  • レイアウトは自動で選ばれ、列の幅の指定は効かない

出典:Marp CLI の README、Slidev「Exporting」、Pandoc User’s Guide「Slide shows」・「Math」

書き出しを CI に任せる

Markdown の資料は Git で管理でき、書き出しを CI(GitHub Actions など)に任せられます。気を付けるのは、PDF・PPTX・画像をブラウザで描く点です。Marp CLI の公式のコンテナイメージ(marpteam/marp-cli)には Chromium が入っているので、PDF と通常の(画像の)PPTX を作れます(Dockerfile)。Dockerfile には LibreOffice を入れる手順が無いので、直せる PPTX には、LibreOffice を足したイメージを自分で用意することになるはずです。これは Dockerfile と README の要件から読み取ったもので、動かしては確かめていません。npx で使うなら、ブラウザを別に用意します。フォルダごと書き出すなら --input-dir(-I)で元の構成を保ったまま -o の出力先に書き出せます(Marp CLI の README)。

Slidev は slidev build で静的な Web のページ(SPA)にできます。公開先のサブパスは --base で指定し、発表者のメモを外すなら --without-notes を付けます。GitHub Pages に出すには、公式のページにある deploy.yml を .github/workflows に置き、リポジトリの設定で Pages の公開元を GitHub Actions にします(Slidev「Building and Hosting」)。

書き出しでつまずく2か所:フォントとローカルの画像

日本語のフォント

Marp の PDF・PPTX・画像も、Slidev と reveal.js の PDF も、ブラウザで描いて作ります。テーマで Web フォントを読み込んでいなければ、使われるのは書き出す環境に入っているフォントです。手元のパソコンでは日本語がきれいに出ても、CI のコンテナに日本語のフォントが無ければ、同じようには出ません。Linux の環境なら、Debian の fonts-noto-cjk のような日本語を含むフォントのパッケージを入れます。そのうえで、作例の style: のようにテーマの font-family でそのフォントを指定しておくと、手元と CI で同じフォントを指せます。

ローカルの画像

Marp CLI は、安全のため、ブラウザを使う変換(PDF・PPTX・画像)では既定で手元のファイルを読みません。手元の画像を使うには --allow-local-files を付けます。ただし README は、危険があるので信頼できる Markdown にだけ使うよう書いています(Marp CLI の README「Security about local files」)。VS Code から書き出すときは、実験的な設定 markdown.marp.strictPathResolutionDuringExport を有効にすると、相対パスをワークスペースから解決し、プレビューと同じ結果に近づけられます。なお、信頼していないワークスペースでは、使えるのは基本のプレビューと入力補完だけで、書き出しや Markdown の中の HTML は制限されます(Marp for VS Code の README)。

Markdown のスライドが向かない資料

直せる PPTX にも道具ごとに再現できないものがあるので、PowerPoint で仕上げる資料かどうかで分けます。

Markdown の道具で仕上げるか、PowerPoint の型から組むか

1

受け取った人が、PowerPoint で配置や見た目まで直すか

例:営業部が数字と言い回しを差し替えて客先に出す

2

会社の PowerPoint のテンプレートどおりに作る必要があるか

例:表紙・ロゴ・文字の大きさが決まっている

どちらかに当てはまるPandoc と –reference-doc でテンプレートに流し込むか、PowerPoint のテンプレートとスクリプトで組む
どちらにも当てはまらないMarp・Slidev・reveal.js で HTML か PDF を作る。PowerPoint が要るときだけ PPTX を書き出して確かめる

出典:Marp CLI の README、Slidev「Exporting」、Pandoc User’s Guide

もう1つ、作り手の側の条件もあります。Markdown の資料は、テキストエディタと Git で回すことが前提です。編集に加わる人が VS Code や GitHub を使わないなら、その人の分の手順を用意できるかを先に確かめます。

PowerPoint のテンプレートとスクリプト(python-pptx など)でスライドの土台を作る方法は、「Claude Code と PowerPoint|テンプレ+スクリプトでスライド土台」で書いています。資料を AI に作らせるところを、当社の動画でも紹介しています。

まず作例の数枚を書き、PPTX を PowerPoint で開いてみる

道具を決める前に、資料を渡す相手に「PowerPoint で直しますか」と1つだけ聞いてください。直さないなら、VS Code だけで始められる Marp で書き始めて構いません。動くデモを見せたいなら Slidev です。直すなら、作例のような数枚を Marp の直せる PPTX、Slidev の pptx-editable、Pandoc の3つで書き出し、PowerPoint で開いて、自分の資料で崩れる所がどこかを見てから決めます。

業務の課題の整理からツールの選定・導入までの相談は、当社のソリューション一覧から受け付けています。

各道具の機能・版・ライセンスは、2026年10月14日に各プロジェクトの公式ドキュメントと GitHub で確かめたものです。どれも更新が速いので、使う前に各公式の最新の説明を見てください。

サービス一覧

業務ツール・Microsoft 365/Google Workspace・AI活用・データ基盤・広告運用・会計ソフト・LINE運用・アクセス解析の8領域で、選定から構築・定着まで支援しています。課題に近い領域からご覧ください。

AT
aurant technologies 編集

上場企業からスタートアップまで、数多くのデータ分析基盤構築・AI導入プロジェクトを主導。単なる技術提供にとどまらず、MA/CRM(Salesforce, Hubspot, kintone, LINE)導入によるマーケティング最適化やバックオフィス業務の自動化など、常に「事業数値(売上・利益)」に直結する改善実績多数。

この記事が役に立ったらシェア: