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向けデスクトップ版は、署名と配布準備を整えた無料公開ベータとして提供する予定です。