STUDIO GUIDE · MARP
Markdownから、発表できるスライドを作る
公開日:2026年10月31日
Marp Studioで最初のデッキを作り、画面で確認し、発表し、PDFへ出力するまで。まずは短い原稿で一周すると、どこを人が編集し、どこをAIに頼めるのかが見えてきます。
Marp Studioが向いている資料
Marp Studioは、文章の構造をMarkdownで保ちながらスライドへ変換する制作環境です。週次報告、設計説明、研修資料、会議のたたき台など、内容を何度も直し、AIやGitとも一緒に扱いたい資料に向いています。
図形を自由に配置することより、見出し・箇条書き・図・コードを同じルールで積み上げることを重視します。元原稿が読めるテキストなので、差分確認や一括修正もしやすくなります。
- 文章をAIと人の両方で編集したい
- 同じテーマで資料を繰り返し作りたい
- PDFにした後の欠落や文字切れにも気づきたい
1. Markdownで2枚だけ書く
先頭の --- で囲まれた部分はスライド全体の設定です。その後は、--- を置くたびに次のスライドへ進みます。最初は装飾よりも、1枚に一つの要点を書くことから始めます。
---
marp: true
theme: default
paginate: true
---
# 週次ミーティング
今週の結論を、最初の1枚に。
---
## 進捗
- 完了したこと
- 次に進めること
- 相談したいこと2. Webデモで書き心地を試す
無料Webデモでは、左側のMarkdownを書き換えると右側のプレビューが更新されます。アカウントは不要で、デッキ本文やファイル名はchirinovelのサーバーへ送信しません。ブラウザー内の下書き復旧とMarkdownの読込・保存も試せます。
まずWebデモで上のサンプルを貼り、見出しや箇条書きを変えてみてください。[発表]を押すと、そのままページ送りできます。PDF、Mermaid、画像フォルダー、独自テーマが必要になった時がデスクトップ版へ移る目安です。
3. デスクトップ版では案件ごとに環境を分ける
デスクトップ版では、Markdownだけでなく、テーマ、画像、Mermaid図、出力先をDeck Environmentとして案件ごとに扱います。複数案件を同時に開いても、検索やテーマが別案件へ混ざらないように分離します。
すでにVS CodeやAIでMarkdownを編集していても、そのファイルを正本のまま利用できます。Marp Studioだけに閉じた形式へ変換する必要はありません。外部で更新した後は再読み込みし、画面側に古い原稿が残っていないことを確認してから保存します。
4. 発表前はプレビューではなく成果物まで確認する
編集画面で正しく見えていても、PDFではフォントの折り返し、画像パス、Mermaidの生成、ページからの文字のはみ出しが変わることがあります。Marp Studioのデスクトップ版はPDF出力後に文字、画像、図を検査し、疑わしい成果物を成功扱いしません。
エラーになった時は、ページ番号と理由を確認します。文章や表を短くする、画像パスを直す、利用するテーマを導入する、といった修正をしてから再出力します。古い正常なPDFがある場合、失敗した出力で上書きしないことも重要です。
- PDF内の文字が原稿と対応しているか
- 画像とMermaid図が読み込めているか
- 既存成果物を失敗時に壊していないか
5. AIへ頼む時も、公式の出力経路を使う
AIにはMarkdownの整理、章立て、表現の短縮、レビューを頼めます。一方、最終PDFを別のMarp CLIで作ると、Marp Studioのテーマや画像処理、検査結果と一致しないことがあります。
そのため、AIが編集した資料も、最終成果物はMarp Studioの画面または公式exportコマンドから出力します。人とAIが同じ原稿を使い、最後の品質確認も同じ経路へそろえることが、安全な運用の要点です。
最初の一周は、短い資料で十分
最初から大きな資料を移行する必要はありません。2〜3枚のデッキを作り、Markdown編集、再読み込み、発表、保存、PDF出力までを一度通してください。流れが合えば、既存資料やAIとの共同編集へ広げられます。
Webデモは今すぐ利用できます。Mac・Windows向けデスクトップ版は、署名と配布準備を整えた無料公開ベータとして提供する予定です。