Marpの使い方|Markdownでスライドを作ってPDF・PowerPointにする

社内研修や提案のスライドを作るたびに、PowerPointで文字の位置や大きさをそろえる作業は時間を取られがちです。内容を少し直すだけでも、レイアウトの崩れを一枚ずつ確かめる手間が生じます。
「Marp」を使えば、Markdownで書いた文字の原稿が、見た目のそろったスライドになります。原稿は文字だけなので、Claude CodeのようなAIに書き足しや修正をそのまま頼むことも可能です。ただし、Marpは書き出しにブラウザを使い、PowerPointの書き出しには文字を直せない制約もあるため、手順と特徴を知っておくことが大切です。
この記事では、MacにMarp CLIを入れる手順から、原稿の書き方、プレビュー、Claude Codeでの修正、PDF・PowerPoint・画像への書き出しまでを実画面で解説します。
この記事を読めば、文字の原稿だけで3枚のスライドを作り、PDFやPowerPointで配れるようになります。最初は練習用の原稿をHTMLに変換し、ブラウザでスライドを確かめるところから始めると迷いません。
目次
- Marpでスライドを作る前に知っておくこと
- Marp CLIをインストールして版を確かめる手順
- 練習用の原稿を保存して3枚のスライドを作る手順
- プレビューを見ながら文字とテーマを直す手順
- Claude Codeにスライドの追加と修正を頼む手順
- PDF・PowerPoint・PNGに書き出して確かめる手順
- Marpの書き出しでうまくいかないときの対処法
- Marpの使い方に関するよくある質問
- まとめ
- 参考リンク
Marpでスライドを作る前に知っておくこと
Marpは、Markdownの原稿をスライドに変換する無料の道具です。Marpでスライドを作る前に知っておきたい点は、以下の4つです。
- 原稿は「---」で区切ると、1枚ずつのスライドになる
- HTML・PDF・PowerPoint・PNGの画像に書き出せる
- PDF・PowerPoint・画像の書き出しには、Chrome・Edge・Firefoxのどれかが要る
- 書き出したPowerPointは1枚ずつ画像になっていて、文字を直せない
PowerPointで文字を直しながら仕上げたい場合は、Marpよりも、ClaudeでPowerPointを作る方法が向いています。
ClaudeでPowerPoint(パワポ)を作る方法!4つの作り方と実例を解説
本記事で使うのは、ターミナルで動かす「Marp CLI」です。画面で原稿を書きながら確かめたい場合は、編集ソフトVS Codeの拡張機能Marp for VS Codeもあります。Marpの全体の案内はMarpの公式サイトで確かめられます。
Marp CLIをインストールして版を確かめる手順
Marp CLIは、Node.jsの「npm」というコマンドで入れられます。Marp CLIをインストールして版を確かめる手順は、以下の3つです。
- Node.jsが入っているかを確かめる
- npmでMarp CLIを入れる
- marp --versionで版を確かめる
Node.jsが入っているかを確かめる
ターミナルを開いて「node -v」と入力します。「v26.5.0」のように版の番号が出れば、Node.jsは入っています。
「command not found」と出た場合は、Node.jsの公式のダウンロードのページからMac用のインストーラーを入れてください。Marp CLIは、Node.jsの18以降で動きます。
npmでMarp CLIを入れる
ターミナルで「npm install -g @marp-team/marp-cli」と入力します。「added 156 packages」のように表示されれば、インストールは完了です。
画面の「npm warn deprecated」の行は、Marp CLIが使う部品の1つについての案内です。撮影では、案内が出てもインストールは最後まで完了しました。HomebrewでMarp CLIを入れる方法(brew install marp-cli)もあります。撮影に使ったMacでは、Homebrewが先にNode.jsを含む16個の部品の更新と3個の部品の追加を求めたため、ほかの作業への影響を避けてnpmで入れました。
marp --versionで版を確かめる
インストールが終わったら、ターミナルで「marp --version」と入力します。
本記事の画面は、Marp CLIの4.5.1で撮りました。新しく入れた場合は、版の番号が違うことがあります。
練習用の原稿を保存して3枚のスライドを作る手順
練習用の原稿は、社内の生成AIのルールを伝える3枚のスライドです。練習用の原稿を保存して3枚のスライドを作る手順は、以下の4つです。
- 作業フォルダを作って移る
- Claude Codeに原稿を保存してもらう
- marp slide.mdでHTMLに変換する
- ブラウザでスライドを確かめる
作業フォルダを作って移る
ターミナルで、以下の2つのコマンドを順に入力します。
- 「mkdir -p ~/touchai-demo/marp-demo」で練習用のフォルダを作る
- 「cd ~/touchai-demo/marp-demo」で練習用のフォルダに移る
本記事では、ホームフォルダの中の「touchai-demo」フォルダに練習用のフォルダを作りました。フォルダの名前は自由に変えてかまいません。
Claude Codeに原稿を保存してもらう
練習用の原稿は、以下の26行です。Marpの原稿は空の行にも意味があるため、空の行は「(空行)」と書いています。
- ---
- marp: true
- theme: default
- paginate: true
- ---
- (空行)
- # 生成AIの使い方 社内ルール
- (空行)
- 2026年11月 総務部
- (空行)
- ---
- (空行)
- ## 入力してはいけない情報
- (空行)
- | 種類 | 例 |
- | --- | --- |
- | 個人情報 | 氏名・住所・電話番号 |
- | 社外秘の資料 | 見積書・契約書 |
- | ログイン情報 | パスワード・APIキー |
- (空行)
- ---
- (空行)
- ## 困ったときの相談先
- (空行)
- - 使ってよいか迷ったら、入力する前に相談する
- - 相談先:総務部 AI担当(内線 1234)
1行目から5行目は原稿全体の設定です。「marp: true」はVS CodeのMarpの拡張機能がMarpの原稿と見分けるための印(Marp CLIでは無くても変換できます)、「theme: default」は見た目のテーマ「paginate: true」はページ番号を付ける設定を表します。「---」の行が、スライドの区切りです。
Claude Codeを使う場合は、先にインストールとログインを済ませておきましょう。入れ方は、Claude Codeの使い方の記事が参考になります。
Claude Codeの使い方を解説!導入から日本語での依頼・変更確認まで
準備ができたら、練習用のフォルダで「claude」と入力してClaude Codeを起動します。入力欄に送る依頼は、以下のとおりです。
- 次の26行を、そのままslide.mdに保存してください。(空行)と書いた行は、何も書かない空の行にしてください。
依頼の文を入力した後に、上の26行をコピーして入力欄に貼り付けてから送ります。
貼り付けた26行は、入力欄では「[Pasted text #1 +26 lines]」とまとめて表示されます。Claude Codeは、(空行)の7行を空の行にしてslide.mdに保存しました。
画像の黒い帯は、撮影に使ったパソコンのユーザー名や契約の情報を隠した部分です。以降の画像も同じです。保存が終わったら、入力欄に「/exit」と入力してClaude Codeを終え、ターミナルで「cat slide.md」と入力して中身を確かめます。
Claude Codeを使わない場合は、テキストエディットで新しい書類を開き、フォーマットのメニューで標準テキストにしてから、26行を書き写して「slide.md」の名前で保存します。テキストエディットの初期の設定では「---」が長い線の記号に変わることがあるため、編集のメニューの自動置換でスマートダッシュを外しておいてください。
marp slide.mdでHTMLに変換する
ターミナルで「marp slide.md」と入力すると、原稿がHTMLのスライドに変換されます。
「slide.md => slide.html」と表示され、同じフォルダにslide.htmlができました。
ブラウザでスライドを確かめる
ターミナルで「open slide.html」と入力すると、いつも使うブラウザでスライドが開きます。
右矢印キーを押すと、次のスライドに進みます。2枚目では、原稿の表がスライドの表になっていました。
右下の「1」「2」は、paginate: trueで付いたページ番号です。
プレビューを見ながら文字とテーマを直す手順
原稿を直しながら見た目を確かめるときは、保存のたびに表示が変わるプレビューを使います。プレビューを見ながら文字とテーマを直す手順は、以下の3つです。
- marp -p -w slide.mdでプレビューを開く
- テキストエディットでテーマを直して保存する
- Ctrl+Cでプレビューを終える
marp -p -w slide.mdでプレビューを開く
ターミナルで「marp -p -w slide.md」と入力すると、スライドのプレビューの窓が開きます。「-p」はプレビューの窓を開く指定「-w」は原稿の保存を見張って変換し直す指定です。
テキストエディットでテーマを直して保存する
プレビューを開いたまま、ターミナルのメニューの「シェル」から「新規ウインドウ」を選び、別の窓を開きます。別の窓で「cd ~/touchai-demo/marp-demo」と入力して練習用のフォルダに移り「open -e slide.md」と入力すると、slide.mdがテキストエディットで開きます。
テキストエディットで直して保存するのは、以下の2か所です。
- 3行目の「theme: default」を「theme: gaia」に変える
- 「# 生成AIの使い方 社内ルール」の上に「<!-- _class: lead -->」の1行を足す
2か所を直したら、Commandキーを押しながらSキーを押して保存します。本記事の撮影では、画面をクリックで操作できない環境だったため、2か所の書き換えと保存は同じ内容をコマンドで行い、結果をターミナルとプレビューで確かめました。
「gaia」はMarpに入っているテーマの1つで、ほかに「uncover」もあります。「<!-- _class: lead -->」は、その1枚だけ文字を中央に寄せる指定です。テーマの見本はMarp Coreのテーマの一覧、指定の書き方はMarpitの公式ドキュメントの指定のページで確かめられます。
直した後の原稿の最初の部分は、以下の画像のとおりです。
保存すると、プレビューの窓が自動で変わり、生成りの背景に文字が中央に並ぶ表紙になりました。
ターミナルには、保存を見つけて変換し直した記録の「slide.md => slide.html」が表示されます。
Ctrl+Cでプレビューを終える
プレビューを終えるときは、ターミナルでCtrlキーを押しながらCキーを押します。プレビューの窓も一緒に閉じます。
Claude Codeにスライドの追加と修正を頼む手順
原稿は文字だけなので、スライドの追加や言い回しの修正をClaude Codeに頼めます。練習用のフォルダで「claude」と入力して起動し、以下の依頼を送りました。
- slide.mdの2枚目と3枚目の間に「使ってよいAIのサービス」というスライドを1枚足してください。中身は「会社が契約したサービスだけを使う」「個人のアカウントに業務の情報を入力しない」の2行にしてください。ほかのスライドは変えず、書いていない数字や固有名詞は足さないでください。
依頼に「ほかのスライドは変えず」「書いていない数字や固有名詞は足さない」と書いたのは、AIが原稿にない数字や社名を足すのを防ぐためです。Claude Codeは、指定した場所に7行を足しました。
緑の行が、Claude Codeが足した行です。足した後は「/exit」で終え、社内に配る前に人が原稿を1枚ずつ確かめてください。
PDF・PowerPoint・PNGに書き出して確かめる手順
原稿ができたら、配りやすい形式に書き出します。PDF・PowerPoint・PNGに書き出して確かめる手順は、以下の2つです。
- 3つの形式に書き出す
- Finderで開いて中身を確かめる
3つの形式に書き出す
ターミナルで、以下の3つのコマンドを順に入力します。
- 「marp slide.md --pdf」でPDFに書き出す
- 「marp slide.md --pptx」でPowerPointに書き出す
- 「marp slide.md --images png」で1枚ずつPNGの画像に書き出す
Claude Codeで1枚足したため、PNGはslide.001.pngからslide.004.pngの4枚になりました。
Finderで開いて中身を確かめる
ターミナルで「open .」と入力すると、今のフォルダがFinderで開きます。slide.pdfを選んでスペースキーを押すと、中身をのぞけます。
PDFには4枚のスライドが入っていました。slide.pptxを同じようにのぞくと、表紙が表示されます。
撮影に使ったMacのクイックルックでは、slide.pptxの左の縮小画像が4枚とも表紙の絵で表示されました。slide.pptxの中には4枚分の別々の画像が入っていることを確かめています。PowerPointのファイルは、PowerPoint・Keynote・Googleスライドで開けます。
slide.003.pngをのぞくと、Claude Codeが足した3枚目のスライドが1枚の画像になっていました。
Marpの書き出しでうまくいかないときの対処法
Marpは、原稿のとおりに書き出すため、画像の読み込みや文字の量でつまずくことがあります。Marpの書き出しでうまくいかないときの対処法は、以下の2つです。
- 画像が出ないときは--allow-local-filesを付ける
- 文字がはみ出すときはスライドを分ける
画像が出ないときは--allow-local-filesを付ける
スライドに自分のパソコンの画像を入れると、PDFや画像への書き出しでは画像が出ません。
試すときは、手元にある好きなPNGの画像を「lock.png」という名前でslide.mdと同じフォルダに置きます。本記事では、編集部が用意した鍵の絵を使いました。続けて、テキストエディットで2枚目の見出しの上に「」の1行を足して保存します。「bg right:35%」は、画像を右側の35%の幅に背景として置く指定です。
書き出すと「Marp CLI has detected accessing to local file. That is blocked by security reason.」の警告が出ました。安全のために、パソコンの中のファイルの読み込みを止めた、という意味です。続けて「marp slide.md --images png」で画像にも書き出しましたが、2枚目に鍵の絵は入っていませんでした。
画像を入れるには、書き出しのコマンドに「--allow-local-files」を付けます。ターミナルで「marp slide.md --images png --allow-local-files」と入力しました。
今度は、2枚目の右側に鍵の絵が入りました。
--allow-local-filesは、原稿がパソコンの中の好きなファイルを読めるようにする指定です。人から受け取った原稿には付けず、自分で書いた原稿にだけ使ってください。
文字がはみ出すときはスライドを分ける
Marpは文字を自動で小さくしないため、1枚に行を詰め込むとスライドの下からはみ出します。試しに、slide.mdとは別に「overflow.md」という原稿を作り「研修で話すこと」の見出しの下に12行の箇条書きを入れました。12行の箇条書きは、以下のとおりです。
- 生成AIとは何か
- 使ってよいサービス
- 入力してはいけない情報
- 個人情報の扱い
- 社外秘の資料の扱い
- ログイン情報の扱い
- 画像や音声の扱い
- 出力の確かめ方
- 著作権の注意
- 社外に出す前の確認
- 困ったときの相談先
- よくある質問
原稿の1行目から4行目には、slide.mdと同じ「---」「marp: true」「theme: gaia」「---」を書きました。「marp overflow.md --images png」で書き出した画像は、以下のとおりです。
はみ出したときは「---」を入れてスライドを2枚に分けるか、1枚の行を減らします。
Marpの使い方に関するよくある質問
Marpの使い方について、よくある質問と答えをまとめました。
Marpは無料で使えますか?
Marp CLIは、MITライセンスで公開されている無料の道具です。会社の資料作りにも使えます。
PowerPointで文字を直せるファイルにできますか?
「marp slide.md --pptx --pptx-editable」で、文字を直せるPowerPointに書き出す試験中の機能があります。ブラウザに加えてLibreOfficeが必要で、テーマによっては見た目が崩れます。詳しくはMarp CLIの公式のページで確かめてください。
Googleスライドで使えますか?
書き出したPowerPointのファイルは、Googleスライドで読み込めます。読み込んだスライドも1枚ずつ画像なので、文字を直したいときはMarpの原稿を直して書き出し直します。
まとめ
Marpを使えば、文字の原稿から見た目のそろったスライドを作り、PDFやPowerPointで配れます。Marpの使い方の要点は、以下の5つです。
- 「npm install -g @marp-team/marp-cli」でMarp CLIを入れる
- 原稿は「---」で区切り、1枚ずつ書く
- 「marp -p -w slide.md」でプレビューしながら直す
- 追加や修正はClaude Codeに頼み、人が1枚ずつ確かめる
- 「--pdf」「--pptx」「--images png」で書き出す
まずは練習用の26行の原稿を保存して、HTMLに変換するところまで試してみてください。



